次の方法で共有


inventoryItem (JSON)

コア インベントリ項目は、使用権を付与できる標準項目を表します。

inventoryItem

inventoryItem オブジェクトの仕様は次のとおりです。

メンバー 種類 説明
url 文字列 この特定のインベントリー項目の一意な識別子。
itemType 文字列 項目の種類。 現在の値は次のとおりです。
  • Unknown
  • ゲーム
  • Movie
  • TVShow
  • MusicVideo
  • GameTrial
  • ViralVideo
  • TVEpisode
  • TVSeason
  • TVSeries
  • VideoPreview
  • Poster
  • Podcast
  • Image
  • BoxArt
  • ArtistPicture
  • GameContent
  • GameDemo
  • Theme
  • XboxOriginalGame
  • GamerTile
  • ArcadeGame
  • GameConsumable
  • Album
  • AlbumDisc
  • AlbumArt
  • GameVideo
  • BackgroundArt
  • TVTrailer
  • GameTrailer
  • VideoShort
  • バンドル
  • XnaCommunityGame
  • Promotional
  • MovieTrailer
  • SlideshowPreviewImage
  • ServerBackedGames
  • Marketplace
  • AvatarItem
  • LiveApp
  • WebGame
  • MobileGame
  • MobilePdlc
  • MobileConsumable
  • アプリ
  • MetroGame
  • MetroGameContent
  • MetroGameConsumable
  • GameLayer
  • GameActivity
  • GameV2
  • SubscriptionV2
  • サブスクリプション

    注意: ゲームは GameV2 によって指定され、消耗品は GameConsumable、非消耗品 DLC は GameContent です。
containers 文字列 これは、この項目を格納する "コンテナー" のセットです。 ユーザーのインベントリーで、特定のコンテナーに属する項目をクエリできます。 これらのコンテナーは、項目が購入によってインベントリーに追加されるときに決定されます。
obtained DateTime 項目がユーザーのインベントリーに追加された日付と時刻。
startDate DateTime 項目が使用できるようになった、または使用できるようになる予定の日付と時刻。
endDate DateTime 項目が使用できなくなった、または使用できなくなる予定の日付と時刻。
state 文字列 項目の状態。 使用できる値は EnabledSuspendedExpiredCanceledRenewed です。
trial ブール値 必須。 この使用権がお試し版,の場合は true、それ以外の場合は false。 使用権のお試し版,を購入した後、完全版を購入した場合は、両方を受け取ります。
trialTimeRemaining TimeSpan null 許容型。 お試し版の残り時間 (分単位)。
consumable 配列 項目が消耗品の場合、これは消耗品インベントリ項目およびその現在の数量に対する一意の識別子 (リンク) のインライン表現を格納します。

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 Object Notation (JSON) オブジェクト リファレンス

リファレンス

/users/me/inventory

/inventory/consumables/{itemID}

/inventory/{itemID}