inventoryItem(JSON)

인타이틀먼트가 허용될 수 있는 표준 항목을 나타내는 핵심 인벤토리 항목입니다.

inventoryItem

inventoryItem 개체 사양은 다음과 같습니다.

멤버	유형	설명
url	문자열	이 특정 인벤토리 항목에 대한 고유 식별자입니다.
itemType	문자열	아이템의 유형입니다. 현재 값은 다음과 같습니다. 알 수 없음 게임 Movie TVShow MusicVideo GameTrial ViralVideo TVEpisode TVSeason TVSeries VideoPreview Poster Podcast Image BoxArt ArtistPicture GameContent GameDemo 테마 XboxOriginalGame GamerTile ArcadeGame GameConsumable Album AlbumDisc AlbumArt GameVideo BackgroundArt TVTrailer GameTrailer VideoShort 번들 XnaCommunityGame Promotional MovieTrailer SlideshowPreviewImage ServerBackedGames 마켓플레이스 AvatarItem LiveApp WebGame MobileGame MobilePdlc MobileConsumable App MetroGame MetroGameContent MetroGameConsumable GameLayer GameActivity GameV2 SubscriptionV2 구독 참고: 게임은 GameV2에 의해, 소모성 콘텐츠는 GameConsumable에 의해, 지속성 DLC는 GameContent에 의해 지정됩니다.
컨테이너	문자열	이 항목을 포함하는 "컨테이너" 집합입니다. 특정 컨테이너에 속하는 항목에 대해 사용자의 인벤트가 쿼리될 수 있습니다. 이러한 컨테이너는 구매를 통해 항목이 인벤토리에 추가되는 시기에 확인됩니다.
가져옴	DateTime	항목이 사용자의 인벤토리에 추가된 날짜 및 시간.
startDate	DateTime	항목이 사용 가능하거나 사용 가능 예정인 날짜 및 시간.
endDate	DateTime	항목이 사용 불가능하거나 사용 불가능 예정인 날짜 및 시간.
state	문자열	항목의 상태. 허용되는 값은 Enabled, Suspended, Expired, Canceled, Renewed입니다.
평가판	부울 값	필수. 이 인타이틀먼트가 평가판인 경우 true이고, 그렇지 않으면 false입니다. 인타이틀먼트의 평가판 버전을 구입하고 전체 버전을 구입한 경우 두 가지 모두 받게 됩니다.
trialTimeRemaining	TimeSpan	Nullable. 평가판의 남은 시간(분).
소모성	array	항목이 소모성인 경우 소모성 인벤토리 항목의 수량과 이에 대한 고유 식별자(링크)의 인라인 표현이 포함되어 있습니다.

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
}

참고 항목

부모

JSON(JavaScript Object Notation) 개체 참조

참조

/users/me/inventory

/inventory/consumables/{itemID}

/inventory/{itemID}