> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Achievement (JSON)

> Achievement (JSON)

# Achievement (JSON)

Un objeto Achievement (versión 2).

## Achievement

El objeto Achievement tiene la siguiente especificación. Todos los miembros son obligatorios.

| Miembro | Tipo | Descripción |
| - | - | - |
| id | string | Identificador del recurso. |
| serviceConfigId | string | SCID de este recurso. Identifica los títulos con los que está relacionado este logro. |
| name | string | El nombre localizado del logro. |
| titleAssociations | matriz de [TitleAssociation](https://devdocs.xbox.com/es/reference/live/rest/json/json-titleassociation) | Una matriz de TitleAssociation. |
| progressState | enumeración **ProgressState** | El estado del progreso: <ul><li>invalid (0): el progreso del logro está en un estado desconocido.</li><li>achieved (1): el logro se ha desbloqueado.</li><li>inProgress (2): el logro está bloqueado, pero el usuario ha progresado hacia su desbloqueo.</li><li>notStarted (3): el logro está bloqueado y el usuario no ha progresado hacia su desbloqueo.</li></ul> |
| progression | [Progression](https://devdocs.xbox.com/es/reference/live/rest/json/json-progression) | El progreso del usuario dentro del logro. |
| mediaAssets | matriz de [MediaAsset](https://devdocs.xbox.com/es/reference/live/rest/json/json-mediaasset) | Los recursos multimedia asociados al logro, como los identificadores de imagen. |
| platform | string | La plataforma en la que se obtuvo el logro. |
| isSecret | valor booleano | Indica si el logro es secreto o no. |
| description | string | La descripción del logro una vez desbloqueado. |
| lockedDescription | string | La descripción del logro antes de desbloquearse. |
| productId | string | El ProductId con el que se publicó el logro. |
| achievementType | enumeración **AchievementType** | El tipo de logro (no es el mismo que el tipo anterior de los logros heredados): <ul><li>invalid (0): un tipo de logro desconocido y no compatible.</li><li>persistent (1): un logro que no tiene fecha de finalización y se puede desbloquear en cualquier momento.</li><li>challenge (2): un logro que tiene una ventana de tiempo específica durante la cual se puede desbloquear.</li></ul> |
| participationType | enumeración **ParticipationType** | El tipo de participación del logro. Los valores válidos son Individual o Group. |
| timeWindow | TimeWindow | La ventana de tiempo durante la cual se puede desbloquear el logro. Solo se admite para los desafíos (Challenges). |
| rewards | matriz de [Reward](https://devdocs.xbox.com/es/reference/live/rest/json/json-reward) | La colección de recompensas obtenidas al desbloquearlo. |
| estimatedTime | TimeSpan | El tiempo estimado que llevará obtener el logro. |
| deeplink | string | Un vínculo profundo al título. |
| isRevoked | valor booleano | Indica si el logro ha sido revocado o no por el equipo de cumplimiento. |

## Sintaxis JSON de ejemplo

```json theme={null}
{
        "id":"3",
        "serviceConfigId":"b5dd9daf-0000-0000-0000-000000000000",
        "name":"Default NameString for Microsoft Achievements Sample Achievement 3",
        "titleAssociations":
        [{
                "name":"Microsoft Achievements Sample",
                "id":3051199919,
                "version":"abc"
        }],
        "progressState":"Achieved",
        "progression":
        {
          "requirements":
          [{
            "id":"12345678-1234-1234-1234-123456789012",
            "current":null,
            "target":"100"
          }],
          "timeUnlocked":"2013-01-17T03:19:00.3087016Z",
        },
        "mediaAssets":
        [{
                "name":"Icon Name",
                "type":"Icon",
                "url":"http://www.xbox.com"
        }],
        "platform":"D",
        "isSecret":true,
        "description":"Default DescriptionString for Microsoft Achievements Sample Achievement 3",
        "lockedDescription":"Default UnachievedString for Microsoft Achievements Sample Achievement 3",
        "productId":"12345678-1234-1234-1234-123456789012",
        "achievementType":"Challenge",
        "participationType":"Individual",
        "timeWindow":
        {
                "startDate":"2013-02-01T00:00:00Z",
                "endDate":"2100-07-01T00:00:00Z"
        },
        "rewards":
        [{
                "name":null,
                "description":null,
                "value":"10",
                "type":"Gamerscore",
                "valueType":"Int"
        },
        {
                "name":"Default Name for InAppReward for Microsoft Achievements Sample Achievement 3",
                "description":"Default Description for InAppReward for Microsoft Achievements Sample Achievement 3",
                "value":"1",
                "type":"InApp",
                "valueType":"String"
        }],
        "estimatedTime":"06:12:14",
        "deeplink":"aWFtYWRlZXBsaW5r",
        "isRevoked":false
    }

```

## Consulte también

##### Elemento primario

[Referencia de objetos de notación de objetos JavaScript (JSON)](https://devdocs.xbox.com/es/reference/live/rest/json/atoc-xboxlivews-reference-json)


## Related topics

- [Award Steam Achievement](https://devdocs.xbox.com/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)
- [Get started with Unreal Engine for PC development](https://devdocs.xbox.com/build/gdk-and-engines/unreal/unreal.md)
- [Attribuer un succès Steam](https://devdocs.xbox.com/fr-CA/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)
- [Steam 実績の付与](https://devdocs.xbox.com/ja-jp/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)
- [Otorgar logro de Steam](https://devdocs.xbox.com/es/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)
