> ## 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/ko/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/ko/reference/live/rest/json/json-progression) | 업적 내에서 사용자의 진행 상황입니다. |
| mediaAssets | [MediaAsset](https://devdocs.xbox.com/ko/reference/live/rest/json/json-mediaasset) 배열 | 이미지 ID와 같이 업적과 관련된 미디어 자산입니다. |
| 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 | 업적을 잠금 해제할 수 있는 시간 창입니다. Challenges에만 지원됩니다. |
| rewards | [Reward](https://devdocs.xbox.com/ko/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
    }

```

## 함께 보기

##### 상위

[JSON(JavaScript Object Notation) 개체 참조](https://devdocs.xbox.com/ko/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)