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

```

## 另请参阅

##### 父主题

[JavaScript 对象表示法 (JSON) 对象参考](/zh-CN/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### 参考

[/users/me/inventory](/zh-CN/reference/live/rest/uri/marketplace/uri-inventory)

[/inventory/consumables/{itemID}](/zh-CN/reference/live/rest/uri/marketplace/uri-inventoryconsumablesitemurl)

[/inventory/{itemID}](/zh-CN/reference/live/rest/uri/marketplace/uri-inventoryitemurl)


## Related topics

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