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

# GET (/users/me/inventory)

> GET (/users/me/inventory)

# GET (/users/me/inventory)

指定されたユーザーに現在関連付けられているインベントリのセットを呼び出し元に返します。
これらの URI のドメインは `inventory.xboxlive.com` です。

* [注釈](#ID4EV)
* [クエリ文字列パラメーター](#ID4EHB)
* [サンプル リクエスト](#ID4EDE)
* [応答本文](#ID4ERE)

## 注釈

この呼び出しの一部として、ポリシー チェック、強制、またはフィルタリングは行われません。呼び出し元は、返される結果の範囲を絞り込むために、クエリ パラメーターを渡すことができます。

呼び出し元は、以前の応答で提供された継続トークンを使用して結果をページングできます: **/users/me/inventory?continuationToken=continuationTokenString**。

呼び出し元は、特定のアイテムに関する情報を確認するために、特定のアイテム URL を指定して details API を呼び出すことができます。

## クエリ文字列パラメーター

| パラメーター | 種類 | 説明 |
| - | - | - |
| availability | string | 返すアイテムの現在の可用性。既定値は "Available" で、現在の日付が開始日から終了日までの範囲内にあるアイテムを返します。その他の値には、すべてのアイテムを返す "All" と、現在の日付が開始日から終了日までの範囲外にあり、そのため現在利用できないアイテムを返す "Unavailable" があります。 |
| container | string | 省略可能。値をゲームの Product ID に設定すると、インベントリからの結果にはそのゲームに関連するアイテムのみが含まれます。これは、サーバーからインベントリを呼び出して結果を特定のゲームの製品に絞り込む場合に特に便利です。 |
| expandSatisfyingEntitlements | string | 返される結果内で、ユーザーが持つすべての充足する権利 (satisfying entitlements) を応答に含めるかどうかを示すフラグ。既定値は "false" です。このパラメーターを "true" の値で使用すると、バンドル アイテム、XBOX One に移行された XBOX 360 の購入品、サブスクリプション特典などの充足する権利を通じてユーザーに付与された製品が結果に追加されます。この値が "false" の場合、Bundle の ProductID などの親アイテムのみが結果に返され、個別に含まれるアイテムは返されません。**注:** このパラメーターを "true" の値で使用することは、itemType パラメーターが URI に含まれていない場合にのみサポートされ、そうでない場合は HTTP 400 エラーを受け取ります。 |
| productIds | string | ユーザーのインベントリから特に取得したい ProductId のコレクションを、',' で区切って指定します。ユーザーのインベントリ結果内に指定した ProductID がない場合、そのアイテムは API 呼び出しの結果には表示されません。expandSatisfyingEntitlements パラメーターを true に設定して bundle の productID を渡すと、bundle に含まれるすべてのアイテムが呼び出し結果に返されます (クエリ文字列で productIds を指定したかどうかに関係なく)。 |
| state | string | 返すアイテムの状態。既定値は "all" で、すべてのアイテムを返します。その他の値には、有効なアイテムのみを返す "Enabled"、一時停止中のアイテムのみを返す "Suspended"、有効期限が切れたアイテムのみを返す "Expired"、キャンセルされたアイテムのみを返す "Cancelled"、更新されたアイテムのみを返す "Renewed" があります。 |

これらに加えて、このリソースは標準のページング機構をサポートしています。

## サンプル リクエスト

この URI メソッドの完全修飾ドメイン名は `https://inventory.xboxlive.com/users/me/inventory です。
		 `

> **注:**\
> どのユーザーが考慮されるかは、提供されたトークンによって異なり、複数のユーザーが含まれる場合があります。単一ユーザーのインベントリが必要な場合は、専用に考慮したい特定のユーザーのユーザー ハッシュも指定する必要があります。

.

## 応答本文

呼び出しが成功した場合、サービスはインベントリ アイテムの配列を返します。「[inventoryItem (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-inventoryitem)」を参照してください。

### サンプル応答

```cpp theme={null}
{
  "pagingInfo": {
    "continuationToken": string,
    "totalItems": int
  },
  "items":
  {
    "url": string,
    "itemType": "Music",
    "titleId": string,
    "containers": string,
    "obtained": DateTime,
    "startDate": DateTime,
    "endDate": DateTime,
    "state": "Enabled"  
}

```

## 関連項目

##### 親

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

##### 詳細情報

[EDS 共通ヘッダー](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/edscommonheaders)

[EDS パラメーター](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/edsparameters)

[EDS クエリ絞り込み条件](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URI](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[追加リファレンス](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Get User Inventory](https://devdocs.xbox.com/services/playfab/api-references/rest/admin/player-item-management/get-user-inventory.md)
- [Get Character Inventory](https://devdocs.xbox.com/services/playfab/api-references/rest/server/player-item-management/get-character-inventory.md)
- [Requesting a User Store ID from your service with X-tokens or OAuth 2.0](https://devdocs.xbox.com/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [Solicitud de un User Store ID desde su servicio con tokens X u OAuth 2.0](https://devdocs.xbox.com/es/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [使用 X-token 或 OAuth 2.0 从服务中请求 User Store ID](https://devdocs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)