> ## 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 のストア

> PlayFab Economy v2 のストアを作成して、アイテム リストのキュレーション、カタログ価格の上書き、ゲーム内プロモーション、割引、期間限定オファーの実施を行います。

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

ストアは、ゲーム内エコノミーを構築および発展させるための優れた方法です。ストアは特殊なアイテム タイプで、アイテムと価格のリストを保持し、アイテムの基本カタログ価格を上書きできます。ストアを使用すると、ゲーム内でアイテムがどこで購入できるかを管理したり、ゲーム内の割引やプロモーションを提供したりできます。その他にもさまざまな用途があります。

## ストアの作成

ストアを作成するには、まずゲーム内でアクセス可能/購入可能にしたい公開済みのカタログ アイテム、Currency、または UGC が他にあることを確認する必要があります。手順は [Economy v2 のクイックスタート](/services/playfab/economy-monetization/economy-v2/quickstart#step-3---publish-an-item-to-the-catalog) を参照してください。

### Game Manager

1. **Economy** > **Catalog (V2)** に移動します。
2. **Stores** タブで **New Store** を選択します。

必要なメタデータを入力します。設定する重要な項目の 1 つは、このストアで提供したいアイテムと、それらのアイテムを上書きしたい価格です。

### API

`CreateDraftItem` を使用してストアを作成できます。

ストアを作成する `CreateDraftItem` リクエストの例:

```json theme={null}
{
  "Item": {
   "Type": "store",
    "Title": {
      "NEUTRAL": "My First Store",
    },
    "StartDate": "2022-09-07T00:00:00.00000000Z",
    "ItemReferences":[
      {
        "Id":"LaserSword",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [{
            "Amounts": [{
              "ItemId": "Diamond",
              "Amount": 1
            }]
          }]
        }
      },
      {
      "Id":"WeaponBundle",
      "PriceOptions": {
        "Prices": [{
          "Amounts": [{
            "ItemId": "Gold",
            "Amount": 10
            },
            {
            "ItemId": "Silver",
            "Amount": 10
          }]
        }],
      },
    }]
   },
   "Publish": true
}
```

***

上記は 2 つのアイテム、`LaserSword` と `WeaponBundle` を販売するストアです。両方のアイテムは既存のカタログ アイテムであり、カタログで定義された基本価格が設定されています。このストアはそれらの既存価格を上書きし、`LaserSword` を 1 個の `Diamond` で、`WeaponBundle` を 10 個の Gold と 10 個の Silver で提供するようになります。

このリクエストは、ストアが作成および公開されたことを示すレスポンスを返します。

```json theme={null}
{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}
```

公開されたストアに関連付けられた `Id` に注目してください。

<Note>
  概念をわかりやすくするために、ストア使用例をよりよく示すため、アイテム ID を GUID からアイテム名に置き換えています。
</Note>

## ストアの使用

ストアは、プレイヤーが `PurchaseInventoryItems` API を呼び出すときに使用されます。`PurchaseInventoryItems` を呼び出す際、オプション プロパティの 1 つに `StoreId` パラメーターがあり、この購入リクエストに適用するストアを渡すことができます。

ストアを使用した `PurchaseInventoryItems` リクエストの例:

```json theme={null}
{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}
```

購入リクエストに渡された `{{StoreId}}` と、想定される `PriceAmount` がストアで設定された 1 個の Diamond のコストと一致していることに注目してください。

## ストアの検索

`SearchItems` API を使用する際、渡せるプロパティの 1 つが `Store` パラメーターです。このパラメーターを使用すると、ストアのコンテキスト内で検索できます。特定のストアにアイテムが存在するかどうかを確認できるだけでなく、ストアのアイテム/コンテンツの上書きされた価格を表示するためにも使用できます。ストアの `AlternateId` を使用して検索することもできます。

```json theme={null}
{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}
```


## Related topics

- [Economy (Legacy) のストアとセール](/ja-jp/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [ストア (Legacy Economy)](/ja-jp/services/playfab/economy-monetization/economy/stores/index.md)
- [ストア (Economy Legacy) クイックスタート](/ja-jp/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [カタログの概要](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [Economy (Legacy) のプレイヤー セグメント向けカスタム ストア](/ja-jp/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)