inventoryItem (JSON)

表示可以授予权利的标准项目的核心库存项目。

inventoryItem

inventoryItem 对象具有以下规范。

成员 类型 说明
url 字符串 此特定库存项目的唯一标识符。
itemType 字符串 项目的类型。 当前值是
  • 未知
  • 游戏
  • 电影
  • TVShow
  • MusicVideo
  • GameTrial
  • ViralVideo
  • TVEpisode
  • TVSeason
  • TVSeries
  • VideoPreview
  • 招贴画
  • 播客
  • 图像
  • BoxArt
  • ArtistPicture
  • GameContent
  • GameDemo
  • 主题
  • XboxOriginalGame
  • GamerTile
  • ArcadeGame
  • GameConsumable
  • 专辑
  • AlbumDisc
  • AlbumArt
  • GameVideo
  • BackgroundArt
  • TVTrailer
  • GameTrailer
  • VideoShort
  • 捆绑包
  • XnaCommunityGame
  • 促销
  • MovieTrailer
  • SlideshowPreviewImage
  • ServerBackedGames
  • 卖场
  • AvatarItem
  • LiveApp
  • WebGame
  • MobileGame
  • MobilePdlc
  • MobileConsumable
  • 应用
  • MetroGame
  • MetroGameContent
  • MetroGameConsumable
  • GameLayer
  • GameActivity
  • GameV2
  • SubscriptionV2
  • 订阅

    注意:游戏由 GameV2 指定,易耗品为 GameConsumable,持久型 DLC 为 GameContent
容器 字符串 这是一组包含此项目的“容器”。 可以在用户的库存中查询属于特定容器的项目。 这些容器在通过购买将项目添加到库存时确定。
已获取 DateTime 项目添加到用户库存的日期和时间。
startDate DateTime 项目可用或即将可用的日期和时间。
endDate DateTime 项目不可用或即将不可用的日期和时间。
state 字符串 项目的状态。 允许的值为已启用已暂停已过期已取消已续订
试用 布尔值 必需。 如果此权利是试用版则为 ture;否则为 false。 如果你购买了权利的试用版,然后购买了完整版,你将收到两个值。
trialTimeRemaining TimeSpan Nullable。 试用剩余的时间(分钟)。
易耗品 数组 如果项目是易耗品,将包含易耗品库存项目的唯一标识符(链接)的内联表示及项目的当前数量。

示例 JSON 语法

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 字符串 特定易耗品库存项目的唯一标识符。
quantity 32 位有符号整数 此库存项目的当前数量。
consumableInventoryItem {
  "url": string,
  "quantity": int
}

另请参阅

父级

JavaScript 对象表示法 (JSON) 对象参考

参考

/users/me/inventory

/inventory/consumables/{itemID}

/inventory/{itemID}