> ## 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)

Um objeto Achievement (versão 2).

<a id="ID4EN" />

## Achievement

O objeto Achievement tem a especificação a seguir. Todos os membros são obrigatórios.

| Membro | Tipo | Descrição |
| - | - | - |
| id | string | Identificador do recurso. |
| serviceConfigId | string | SCID deste recurso. Identifica os títulos aos quais esta conquista está relacionada. |
| name | string | O nome localizado da conquista. |
| titleAssociations | matriz de [TitleAssociation](/pt-BR/reference/live/rest/json/json-titleassociation) | Uma matriz de TitleAssociation. |
| progressState | Enumeração **ProgressState** | O estado do progresso: <ul><li>invalid (0): o progresso da conquista está em um estado desconhecido.</li><li>achieved (1): a conquista foi desbloqueada.</li><li>inProgress (2): a conquista está bloqueada, mas o usuário progrediu em direção ao desbloqueio.</li><li>notStarted (3): a conquista está bloqueada e o usuário não progrediu em direção ao desbloqueio.</li></ul> |
| progression | [Progression](/pt-BR/reference/live/rest/json/json-progression) | O progresso do usuário na conquista. |
| mediaAssets | matriz de [MediaAsset](/pt-BR/reference/live/rest/json/json-mediaasset) | Os ativos de mídia associados à conquista, como IDs de imagem. |
| platform | string | A plataforma na qual a conquista foi obtida. |
| isSecret | Valor booliano | Indica se a conquista é secreta ou não. |
| description | string | A descrição da conquista quando desbloqueada. |
| lockedDescription | string | A descrição da conquista antes de ser desbloqueada. |
| productId | string | O ProductId com o qual a conquista foi lançada. |
| achievementType | Enumeração **AchievementType** | O tipo de conquista (não é o mesmo que o tipo anterior nas conquistas herdadas): <ul><li>invalid (0): um tipo de conquista desconhecido e sem suporte.</li><li>persistent (1): uma conquista que não tem data de término e pode ser desbloqueada a qualquer momento.</li><li>challenge (2): uma conquista que tem uma janela de tempo específica durante a qual pode ser desbloqueada.</li></ul> |
| participationType | Enumeração **ParticipationType** | O tipo de participação da conquista. Os valores válidos são Individual ou Group. |
| timeWindow | TimeWindow | A janela de tempo durante a qual a conquista pode ser desbloqueada. Com suporte apenas para desafios. |
| rewards | matriz de [Reward](/pt-BR/reference/live/rest/json/json-reward) | A coleção de recompensas obtidas quando desbloqueada. |
| estimatedTime | TimeSpan | O tempo estimado necessário para obter a conquista. |
| deeplink | string | Um link profundo para o título. |
| isRevoked | Valor booliano | Indica se a conquista foi revogada ou não pela fiscalização. |

<a id="ID4EIAAC" />

## Exemplo de sintaxe JSON

```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
    }

```

<a id="ID4ERAAC" />

## Confira também

<a id="ID4ETAAC" />

##### Pai

[Referência de objetos JSON (JavaScript Object Notation)](/pt-BR/reference/live/rest/json/atoc-xboxlivews-reference-json)


## Related topics

- [Achievements](/services/xbox-services/player-data/achievements/index.md)
- [Award Steam Achievement](/api-reference/platform-specific-methods/award-steam-achievement.md)
- [Use the GDK with Unreal Engine](/build/gdk-and-engines/unreal/unreal.md)
- [Uso del GDK con Unreal Engine](/es/build/gdk-and-engines/unreal/unreal.md)
- [在 Unreal Engine 中使用 GDK](/zh-CN/build/gdk-and-engines/unreal/unreal.md)