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

Achievement オブジェクト (バージョン 2)。

## Achievement

Achievement オブジェクトの仕様は次のとおりです。すべてのメンバーが必須です。

| メンバー | 型 | 説明 |
| - | - | - |
| id | string | リソース識別子。 |
| serviceConfigId | string | このリソースの SCID です。この実績が関連付けられているタイトルを特定します。 |
| name | string | ローカライズされた実績名。 |
| titleAssociations | [TitleAssociation](https://devdocs.xbox.com/ja-jp/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](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-progression) | 実績内でのユーザーの進捗。 |
| mediaAssets | [MediaAsset](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-mediaasset) の配列 | 画像 ID などの、実績に関連付けられたメディア アセット。 |
| platform | string | 実績を獲得したプラットフォーム。 |
| isSecret | ブール値 | 実績がシークレットかどうか。 |
| description | string | ロック解除された実績の説明。 |
| lockedDescription | string | ロック解除される前の実績の説明。 |
| productId | string | 実績がリリースされた ProductId。 |
| achievementType | **AchievementType** 列挙体 | 実績の種類 (レガシー実績における従来の type と同じではありません): <ul><li>invalid (0): 不明でサポートされない実績の種類です。</li><li>persistent (1): 終了日がなく、いつでもロック解除できる実績です。</li><li>challenge (2): ロック解除可能な特定の時間枠がある実績です。</li></ul> |
| participationType | **ParticipationType** 列挙体 | 実績の参加種別。有効な値は Individual または Group です。 |
| timeWindow | TimeWindow | 実績をロック解除できる時間枠。Challenges でのみサポートされます。 |
| rewards | [Reward](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-reward) の配列 | ロック解除時に獲得する報酬のコレクション。 |
| estimatedTime | TimeSpan | 実績を獲得するのにかかる推定時間。 |
| deeplink | string | タイトルへのディープリンク。 |
| isRevoked | ブール値 | 実績が強制対応によって取り消されたかどうか。 |

## サンプル 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
    }

```

## 関連項目

##### 親

[JavaScript Object Notation (JSON) オブジェクト リファレンス](https://devdocs.xbox.com/ja-jp/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)