> ## 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 Beta SDK を使用してプレイヤーを認証し、カタログを検索し、アイテムを購入し、Economy v2 のプレイヤー インベントリに表示されることを確認します。

# クイックスタート: プレイヤーのインベントリに最初のアイテムを追加する

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

PlayFab Beta SDK を使用してアイテムを購入し、それがプレイヤーのインベントリに追加されたことを確認することで、プレイヤー インベントリに親しみましょう。API を介してタイトルと対話するためのエンティティ トークンを取得したら、カタログでアイテムを検索し、そのアイテムを購入して、プレイヤーのインベントリを取得して購入したアイテムを見つけます。

## 前提条件

* [PlayFab 開発者アカウント](https://developer.playfab.com)
* PlayFab Beta SDK ([Postman クイックスタート](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections) で詳細情報を確認できます)
* カタログに少なくとも 1 つのアイテム ([Economy v2 のクイックスタート](/services/playfab/economy-monetization/economy-v2/quickstart) で詳細情報を確認できます)
* アイテムを購入するのに十分な仮想通貨を持つ少なくとも 1 人のプレイヤー

## プレイヤーとしてサインインする

このクイックスタートの残りの API 呼び出しに必要なセキュリティ トークンを受け取るには、まずプレイヤーとしてサインインする必要があります。詳細については、[プレイヤー認証](/services/playfab/identity/player-identity/login) ページを参照してください。

## アイテムを検索する

カタログ内のアイテムを検索するには、`Search` を呼び出します。呼び出しのボディで:

```json theme={null}
{
  "Search": "[Item Title]",
  "Top": 1
}
```

* `Search` は、カタログ内のすべてのアイテムの Title、Description、および Keywords に対してあいまい検索される検索文字列です
* `Top` は、返す結果の件数を決定する整数です。この場合は 1 件だけ必要です

<Note>
  さらに詳しいフィールドについては、[Search のクイックスタート](/services/playfab/economy-monetization/economy-v2/catalog/search) を参照してください。
</Note>

レスポンスから、次のフィールドを取得します。

* `Items` > `Id` - アイテムのカタログ ID
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId` - アイテムの購入に使用する仮想通貨の ID
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount` - アイテムの購入に必要な仮想通貨の量

<Note>
  アイテムの価格を設定できるのは Title Entity のみです。
</Note>

## アイテムを購入する

アイテムを購入するには、`PurchaseInventoryItems` を呼び出します。呼び出しのボディで:

```json theme={null}
{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
```

* `Item.Id` はアイテムの ID (前のステップの `Search` レスポンスから取得)
* `Amount` はプレイヤーが購入しているアイテムの数
* `ItemId` はアイテムの購入に使用する仮想通貨の ID (前のステップの `Search` レスポンスから取得)
* `Amount` はアイテムの購入に必要な仮想通貨の量 (前のステップの `Search` レスポンスから取得)

## プレイヤーのインベントリ アイテムを取得する

`GetInventoryItems` を介して、プレイヤーが新たに購入したアイテムを確認します。呼び出しではボディが空であることを確認してください。ボディでエンティティを指定できますが、情報はすでにヘッダーのエンティティ トークンで渡されているため、必須ではありません。

レスポンスには、プレイヤーが所有する各アイテムの ID と各アイテムの数量が含まれます。新しく購入したアイテムはプレイヤーのインベントリに含まれています。

<Note>
  プレイヤーがすでに同じ `StackId` のアイテムをインベントリに持っている場合、購入後にアイテムの新しいインスタンスは表示されず、代わりに `Amount` フィールドが増加します。
</Note>

## トラブルシューティング

* 残高不足
  * `PurchaseInventoryItems` を呼び出して `422: InsufficientFunds` エラーが返された場合、プレイヤーはアイテムを購入するのに十分な仮想通貨を持っていません。`AddInventoryItems` を呼び出して (タイトル エンティティ トークンが必要)、または Game Manager の **\[Title]** > **Players** > **\[Player]** > **`Inventory (V2)`** に移動することで、プレイヤーに仮想通貨を付与できます。
* 指定された価格でアイテムを購入できません。
  * `PurchaseInventoryItems` を呼び出して `1071` エラー コードが返された場合、`PriceAmounts` フィールドがカタログで指定された価格と一致していません。

## 次のステップ

プレイヤーの最初のアイテムを購入したので、アイテムを消費したり、アイテムをストアに追加してセールに出したり、アイテムを含むバンドルを作成および購入したりできます。

<Note>
  \[!div class="nextstepaction"] [プレイヤー インベントリのチュートリアル](/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
</Note>

<Note>
  \[!div class="nextstepaction"] [ストア](/services/playfab/economy-monetization/economy-v2/catalog/stores)
</Note>

<Note>
  \[!div class="nextstepaction"] [バンドル](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
</Note>


## Related topics

- [プレイヤー カスタム プロパティのクイックスタート](/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [プレイヤーデータのクイックスタート](/ja-jp/services/playfab/player-progression/player-data/quickstart.md)
- [クイックスタート (Windows) - Party とマルチプレイヤー](/ja-jp/services/playfab/sdks/unified-sdk/quickstart-windows-party.md)
- [プレイヤーインベントリの使用](/ja-jp/services/playfab/player-progression/player-data/player-inventory.md)
- [トレードのクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/trading/trading-quickstart.md)