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

# inventoryItem (JSON)

> inventoryItem (JSON)

# inventoryItem (JSON)

핵심 인벤토리 항목은 사용 권한을 부여할 수 있는 표준 항목을 나타냅니다.

## inventoryItem

inventoryItem 개체는 다음 사양을 가집니다.

| 멤버 | 형식 | 설명 |
| - | - | - |
| url | string | 이 특정 인벤토리 항목의 고유 식별자입니다. |
| itemType | string | 항목의 유형입니다. 현재 값은 다음과 같습니다. <ul><li>**Unknown**</li><li>**Game**</li><li>**Movie**</li><li> **TVShow**</li><li>**MusicVideo**</li><li>**GameTrial**</li><li>**ViralVideo**</li><li>**TVEpisode**</li><li>**TVSeason**</li><li>**TVSeries**</li><li>**VideoPreview**</li><li>**Poster**</li><li>**Podcast**</li><li>**Image**</li><li>**BoxArt**</li><li>**ArtistPicture**</li><li>**GameContent**</li><li>**GameDemo**</li><li>**Theme**</li><li>**XboxOriginalGame**</li><li>**GamerTile**</li><li>**ArcadeGame**</li><li>**GameConsumable**</li><li>**Album**</li><li>**AlbumDisc**</li><li>**AlbumArt**</li><li>**GameVideo**</li><li>**BackgroundArt**</li><li>**TVTrailer**</li><li>**GameTrailer**</li><li>**VideoShort**</li><li>**Bundle**</li><li>**XnaCommunityGame**</li><li>**Promotional**</li><li>**MovieTrailer**</li><li>**SlideshowPreviewImage**</li><li>**ServerBackedGames**</li><li>**Marketplace**</li><li>**AvatarItem**</li><li>**LiveApp**</li><li>**WebGame**</li><li>**MobileGame**</li><li>**MobilePdlc**</li><li>**MobileConsumable**</li><li>**App**</li><li>**MetroGame**</li><li>**MetroGameContent**</li><li>**MetroGameConsumable**</li><li>**GameLayer**</li><li>**GameActivity**</li><li>**GameV2**</li><li>**SubscriptionV2**</li><li>**Subscription**</li></ul>  **참고:** 게임은 **GameV2**로, 소비재는 **GameConsumable**로, 내구성 DLC는 **GameContent**로 지정됩니다. |
| containers | string | 이 항목이 포함된 "컨테이너" 집합입니다. 사용자의 인벤토리에 대해 특정 컨테이너에 속하는 항목을 쿼리할 수 있습니다. 이러한 컨테이너는 항목이 구매를 통해 인벤토리에 추가될 때 결정됩니다. |
| obtained | DateTime | 항목이 사용자의 인벤토리에 추가된 날짜 및 시간입니다. |
| startDate | DateTime | 항목이 사용 가능해진(또는 사용 가능해질) 날짜 및 시간입니다. |
| endDate | DateTime | 항목이 사용 불가능해진(또는 사용 불가능해질) 날짜 및 시간입니다. |
| state | string | 항목의 상태입니다. 허용되는 값은 **Enabled**, **Suspended**, **Expired**, **Canceled**, **Renewed**입니다. |
| trial | 부울 값 | 필수입니다. 이 사용 권한이 평가판이면 true이고, 그렇지 않으면 false입니다. 사용 권한의 평가판 버전을 구입한 후 정식 버전을 구입하면 둘 다 받게 됩니다. |
| trialTimeRemaining | TimeSpan | Null 허용. 평가판에 남아 있는 시간(분 단위)입니다. |
| consumable | 배열 | 항목이 소비재인 경우 소비재 인벤토리 항목의 고유 식별자(링크)의 인라인 표현과 현재 수량을 포함합니다. |

## 샘플 JSON 구문

```json theme={null}
inventoryItem {
  "url": string,
  "itemType": "Music" | "Video" | "Game" | "AvatarItem" | "Subscription" | "DLC" | "Consumable" | ...,
  "obtained": DateTime,
  "beginDate": DateTime,
  "endDate": DateTime,
  "state": "Unavailable" | "Available" | "Suspended" | "Expired",
  "trial": true,
  "trialTimeRemaining":"23:12:14",
  ("consumable": {"url": string, "quantity": int})
}

```

## 소비재 인벤토리 항목

소비재 엔터티는 소비재 항목에 대한 최소한의 속성 집합을 나타냅니다.

\| 멤버| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| url| string| 특정 소비재 인벤토리 항목의 고유 식별자입니다.|
\| quantity| 32비트 부호 있는 정수| 이 인벤토리 항목의 현재 수량입니다.|

```json theme={null}
consumableInventoryItem {
  "url": string,
  "quantity": int
}

```

## 함께 보기

##### 상위

[JSON(JavaScript Object Notation) 개체 참조](https://devdocs.xbox.com/ko/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### 참조

[/users/me/inventory](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-inventory)

[/inventory/consumables/{itemID}](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-inventoryconsumablesitemurl)

[/inventory/{itemID}](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-inventoryitemurl)


## Related topics

- [Revoke Inventory Item](https://devdocs.xbox.com/services/playfab/api-references/rest/server/player-item-management/revoke-inventory-item.md)
- [Get Inventory Items](https://devdocs.xbox.com/services/playfab/api-references/rest/economy/inventory/get-inventory-items.md)
- [Update Inventory Items](https://devdocs.xbox.com/services/playfab/api-references/rest/economy/inventory/update-inventory-items.md)
- [Delete Inventory Items](https://devdocs.xbox.com/api-reference/inventory/delete-inventory-items.md)
- [Subtract Inventory Items](https://devdocs.xbox.com/services/playfab/api-references/rest/economy/inventory/subtract-inventory-items.md)