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

# Economy v2 の仮想通貨クイックスタート

> Game Manager またはタイトル エンティティ トークンを使用したカタログ API を使用して、最初の PlayFab Economy v2 仮想通貨を作成および構成します。

# 最初の仮想通貨をセットアップする

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

[PlayFab Services SDK](/services/playfab/sdks/playfab-sdk-intro) を使用して最初の仮想通貨をセットアップし、PlayFab Economy を始めましょう。API を介してタイトルと対話するためのエンティティ トークンを取得したら、仮想通貨を作成および構成します。

## 前提条件

* [PlayFab 開発者アカウント](https://developer.playfab.com)
* PlayFab Beta SDK ([Postman クイックスタート](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections) で詳細情報を確認できます)

## タイトル エンティティ トークンを取得する

API を介してタイトル構成データを変更するには、まずタイトル エンティティ トークンを取得する必要があります。詳細については、[Postman クイックスタート](/services/playfab/sdks/postman/postman-quickstart#getting-a-title-entity-token) を参照してください。

## 新しい仮想通貨を作成する

新しい仮想通貨を作成するには、Currency タイプの下書きアイテムを作成する必要があります。

### Game Manager

1. Game Manager の **Economy** タブに移動し、**Catalog (V2)** を選択します。
2. **Currency** を選択し、**New currency** を選択します。
3. **Title** を編集し、**Description** を追加します - たとえば、`Diamonds`、`Our in-game currency of choice.`。
4. **Save and publish** を選択して変更を完了します。
5. **Currency** リストで通貨を確認します。

### REST API

[CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item) を呼び出します。次の本文を使用します。

```JSON theme={null}
{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "diamonds"
      }
    ],
    "Title": {
      "NEUTRAL": "Diamonds"
    },
    "Description": {
      "NEUTRAL": "Our in-game currency of choice."
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
  },
  "Publish": true,
  "CustomTags": {
    "user": "{{Email}}"
  }
}
```

***

* `FriendlyId` は通貨コードで、1 ～ 3 個の英数字値を含むことができます
* `Title` はプレイヤーに表示される表示名です
* `ContentType` は Economy アイテムのカテゴリ分けです。まず ⚙️ > Title Settings > Economy > Catalog (V2) Settings で Content Type を設定する必要があります。
* `StartDate` は通貨がプレイヤーに表示される日時を表す datetime 文字列です (デフォルトは作成時刻)

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

* 欠落した/期限切れのエンティティ トークン
  * `CreateDraftItem` を呼び出そうとして `401: Unauthorized` エラーが返された場合、タイトル エンティティ トークンの取得を忘れたか、期限切れの可能性があります
* コンテンツ タイプ `''` はサポートされていません
  * `CreateDraftItem` を呼び出そうとして上記のメッセージを含む `CatalogBadRequest` が返された場合、まず Game Manager のタイトル設定ページの下のカタログ設定タブで content type を作成する必要があります

## 次のステップ

最初の仮想通貨をセットアップしたので、次のことができます。

1. アプリ ストアで販売する PlayFab バンドルに通貨を追加します。
2. [AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items) を使用して、ゲーム サーバーからプレイヤーに通貨を報酬として与えます。
3. 通貨に対応する価格をカタログ アイテムに割り当てます。
4. [PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items) を使用して、プレイヤーがその通貨でカタログ アイテムを購入できるようにします。


## Related topics

- [アイテム (レガシー Economy) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy (レガシー) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/quickstart.md)
- [ストア (Economy Legacy) クイックスタート](/ja-jp/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [クイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [不正防止のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)