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

# アイテムとインベントリの概要

> アイテム タイプ、バンドル、ストア、仮想通貨、プレイヤーの所有権追跡など、PlayFab Economy v2 のカタログとインベントリの概念について学びます。

# PlayFab のアイテムとインベントリの概要

<Info>
  Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、[PlayFab フォーラム](https://community.playfab.com) を参照してください。
</Info>

アイテムとインベントリは、魅力的で没入感のあるゲームを作成するために不可欠な機能です。これらは、プレイヤーにカスタマイズ オプション、報酬、進行システム、および収益化の機会を提供できるようにします。

PlayFab Economy v2 は、仮想商品を作成および管理するための柔軟で強力なプラットフォームを提供します。耐久財、消耗品、バンドル、サブスクリプション、仮想通貨など、さまざまな種類のアイテムを定義でき、プレイヤーのインベントリ全体でアイテムの所有権と使用状況を追跡できます。

## 主要な概念

* **カタログ** - カタログは、ゲーム内で利用可能なすべてのアイテムのコレクションです。カタログを使用すると、ゲームの仮想アイテムを簡単に管理できます。詳細については、[カタログの概要](/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview) を参照してください。
* **カタログ アイテム** – カタログで定義された個別のアイテム。武器、衣装、パワーアップ、ルート ボックスなど、あらゆる種類の仮想商品を表すことができます。ゲーム デザインに合わせて、プロパティと動作をカスタマイズできます。
* **カタログ ストア** - ストアを使用すると、シーズナル イベント、プロモーション、テストなど、さまざまな目的で複数のアイテム リストを作成できます。[ストア](/services/playfab/economy-monetization/economy-v2/catalog/stores) を参照してください。
* **バンドル** - バンドルは、他のアイテムへの参照を含むカタログ アイテムです。プレイヤーがバンドルを購入すると、参照されたアイテムがアンパックされてインベントリに追加されます。
* **サブスクリプション** - サブスクリプションは、耐久財への期間ベースのアクセスを付与します。サブスクリプション内のアイテムは、サブスクリプションの期間中プレイヤーのインベントリで利用できます。[サブスクリプション](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions) を参照してください。
* **プレイヤー インベントリ コレクション** - インベントリは、プレイヤーがゲーム内で所有するアイテムの記録です。アイテムの数量、仮想通貨の残高、カスタム プロパティに関する情報が含まれます。すべてのプレイヤー アカウントは、[コレクション](/services/playfab/economy-monetization/economy-v2/inventory/collections) と呼ばれる 1 つ以上のインベントリを持つことができます。
* **スタック** - スタックにより、同じアイテムの複数の異なるインスタンスを 1 つのインベントリ内に存在させることができ、それぞれ独自の数量とカスタム プロパティを持ちます。[スタック](/services/playfab/economy-monetization/economy-v2/inventory/stacks) を参照してください。
* **仮想通貨** - 仮想通貨は、ゲーム内で交換手段として使用されるアイテム タイプです。仮想通貨を使用して、カタログやストアからアイテムを購入したり、アプリ内購入からのソフト通貨を実装したり、ゲームプレイの仕組みを動かしたりできます。

## 主要な API

ゲーム内でアイテムやインベントリを操作するための豊富な API が用意されています。これらの API を使用して、アイテムの購入、アイテムの付与、インベントリの更新、プレイヤー間のアイテム転送、取引履歴のクエリなどのアクションを実行できます。

### インベントリ管理

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)** - エンティティの現在のインベントリを取得します。`ContinuationToken` によるページングと、[TurboLoading](/services/playfab/economy-monetization/economy-v2/inventory/turboloading) 経由の一括読み込みをサポートします。
* **[AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)** - プレイヤーのインベントリに直接アイテムを追加します。
* **[SubtractInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/subtract-inventory-items)** - プレイヤーのインベントリ内のアイテムの数量を減らします。
* **[UpdateInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/update-inventory-items)** - アイテムの数量を設定するか、インベントリ アイテムの [表示プロパティ](/services/playfab/economy-monetization/economy-v2/inventory#display-properties) を変更します。
* **[DeleteInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/delete-inventory-items)** - プレイヤーのインベントリからアイテムのスタック全体を削除します。

### 購入と取引

* **[PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)** - 仮想通貨を使用してカタログ アイテムまたはバンドルを購入します。プレイヤーのインベントリから通貨を差し引き、購入したアイテムを付与します。
* **[TransferInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/transfer-inventory-items)** - プレイヤー間、プレイヤーのインベントリ コレクション間、同じインベントリ内のスタック間でアイテムを転送します。

### バッチ操作

* **[ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)** - 最大 10 個のインベントリ操作 (Add、Subtract、Update、Purchase、Transfer、Delete) を単一のアトミック リクエストにバッチ処理します。いずれかの操作が失敗すると、バッチ全体がロールバックされます。

### 履歴と診断

* **[GetTransactionHistory](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-transaction-history)** - プレイヤーのインベントリから取引イベントを取得します。タイムスタンプによるフィルタリングとページングをサポートし、完全な操作履歴を確認できます。[取引履歴](/services/playfab/economy-monetization/economy-v2/inventory/transaction-history) を参照してください。

### 信頼性

* **べき等性** - すべてのインベントリ API は `IdempotencyId` パラメーターをサポートしており、副作用の重複なしにリクエストを安全に再試行できます。ID は 14 日間強制されます。[べき等性](/services/playfab/economy-monetization/economy-v2/inventory#idempotency) を参照してください。

各操作の完全な API リファレンスと詳細な例については、[Inventory API のドキュメント](/services/playfab/economy-monetization/economy-v2/inventory) および [PlayFab REST API リファレンス](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory) を参照してください。


## Related topics

- [プレイヤーインベントリの使用](/ja-jp/services/playfab/player-progression/player-data/player-inventory.md)
- [クイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [プレイヤー インベントリのクイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [PlayFab Inventory API](/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/index.md)
- [Economy (レガシー) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/quickstart.md)