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

成就物件 (第 2 版)。

<a id="ID4EN" />

## Achievement

Achievement 物件具有下列規格。所有成員都是必要的。

| 成員 | 類型 | 描述 |
| - | - | - |
| id | string | 資源識別碼。 |
| serviceConfigId | string | 此資源的 SCID。識別此成就相關的遊戲。 |
| name | string | 當地語系化的成就名稱。 |
| titleAssociations | [TitleAssociation](/zh-TW/reference/live/rest/json/json-titleassociation) 陣列 | TitleAssociation 的陣列。 |
| progressState | **ProgressState** 列舉 | 進度狀態：<ul><li>invalid (0)：成就進度處於未知狀態。</li><li>achieved (1)：成就已解鎖。</li><li>inProgress (2)：成就已鎖定，但使用者在解鎖方面已有進度。</li><li>notStarted (3)：成就已鎖定，且使用者在解鎖方面尚無任何進度。</li></ul> |
| progression | [Progression](/zh-TW/reference/live/rest/json/json-progression) | 使用者在此成就中的進度。 |
| mediaAssets | [MediaAsset](/zh-TW/reference/live/rest/json/json-mediaasset) 陣列 | 與成就相關聯的媒體資產，例如影像識別碼。 |
| platform | string | 獲得成就的平台。 |
| isSecret | 布林值 | 成就是否為祕密成就。 |
| description | string | 解鎖後的成就描述。 |
| lockedDescription | string | 解鎖前的成就描述。 |
| productId | string | 發行此成就時所搭配的 ProductId。 |
| achievementType | **AchievementType** 列舉 | 成就的類型 (與舊版成就先前的類型不同)：<ul><li>invalid (0)：未知且不支援的成就類型。</li><li>persistent (1)：沒有結束日期、可隨時解鎖的成就。</li><li>challenge (2)：具有特定可解鎖時間範圍的成就。</li></ul> |
| participationType | **ParticipationType** 列舉 | 成就的參與類型。有效值為 Individual 或 Group。 |
| timeWindow | TimeWindow | 可解鎖成就的時間範圍。僅支援挑戰。 |
| rewards | [Reward](/zh-TW/reference/live/rest/json/json-reward) 陣列 | 解鎖時獲得的獎勵集合。 |
| estimatedTime | TimeSpan | 獲得成就的預估所需時間。 |
| deeplink | string | 進入遊戲的深層連結。 |
| isRevoked | 布林值 | 成就是否已因強制執行而被撤銷。 |

<a id="ID4EIAAC" />

## 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" />

## 另請參閱

<a id="ID4ETAAC" />

##### 上層

[JavaScript 物件標記法 (JSON) 物件參考](/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json)


## Related topics

- [Achievements](/services/xbox-services/player-data/achievements/index.md)
- [Award Steam Achievement](/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)
- [Use the GDK with Unreal Engine](/build/gdk-and-engines/unreal/unreal.md)
- [Attribuer un succès Steam](/fr/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)
- [Conceder conquista do Steam](/pt-BR/services/playfab/api-references/rest/server/platform-specific-methods/award-steam-achievement.md)