> ## 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**  **注:** ゲームは **GameV2**、コンシューマブルは **GameConsumable**、永続型 DLC は **GameContent** で示されます。</li></ul> |
| containers | string | このアイテムを含む「コンテナ」のセットです。ユーザーのインベントリは、特定のコンテナに属するアイテムに対して照会できます。これらのコンテナは、アイテムが購入によってインベントリに追加された時点で決定されます。 |
| obtained | DateTime | アイテムがユーザーのインベントリに追加された日時。 |
| startDate | DateTime | アイテムが使用可能になった、または使用可能になる日時。 |
| endDate | DateTime | アイテムが使用不能になった、または使用不能になる日時。 |
| state | string | アイテムの状態。指定可能な値は **Enabled**、**Suspended**、**Expired**、**Canceled**、**Renewed** です。 |
| trial | ブール値 | 必須。このエンタイトルメントが試用版の場合は true、そうでない場合は false。試用版を購入した後にフル バージョンを購入すると、両方を受け取ります。 |
| trialTimeRemaining | TimeSpan | Null 許容。試用版の残り時間 (分単位)。 |
| consumable | array | アイテムがコンシューマブルの場合、これにはコンシューマブル インベントリ アイテムの一意識別子 (リンク) と現在の数量のインライン表現が含まれます。 |

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

```

## 関連項目

##### 親

[JavaScript Object Notation (JSON) オブジェクト リファレンス](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### リファレンス

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

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

[/inventory/{itemID}](https://devdocs.xbox.com/ja-jp/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)