> ## 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 現已正式推出。如需支援與意見反應，請前往 [PlayFab 論壇](https://community.playfab.com)。
</Info>

商店是建構與發展遊戲內 Economy 的絕佳方式。商店是一種特殊的項目類型，可保存項目與價格的清單，並可讓您覆寫項目的基本目錄價格。商店可用來管理項目在您遊戲中的可購買位置、提供遊戲內折扣與促銷等，還有更多用途！

## 建立商店

若要建立商店，您必須先確定您已有其他想要在遊戲中可存取/可購買的已發佈目錄項目、貨幣或 UGC。您可以依照 [Economy v2 快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart#step-3---publish-an-item-to-the-catalog)中的步驟進行

### GameManager

1. 瀏覽至 **Economy** > **Catalog (V2)**。
2. 在 **Stores** 索引標籤下，選取 **New Store**。

填入所需的中繼資料，其中一項重點是設定您希望在此商店提供的項目，以及您想要將其覆寫成的價格。

### 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
}
```

***

上述是一個販售兩個項目的商店：`LaserSword` 和 `WeaponBundle`。這兩個項目都是現有的目錄項目，在目錄中已定義了某些基本價格。此商店會覆寫其現有價格，現在以 1 個 `Diamond` 提供 `LaserSword`，並以 10 Gold 和 10 Silver 提供 `WeaponBundle`。

此要求會傳回商店已建立並發佈的回應：

```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` 時，其中一個選用屬性是 `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 時，您可以傳入的其中一個屬性是 `Store` 參數。此參數可讓您在商店的內容中進行搜尋。除了能夠檢查項目是否存在於特定商店之外，也可以用來顯示商店項目/內容的覆寫價格。您也可以使用商店的 `AlternateId` 來搜尋商店。

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


## Related topics

- [Economy v2 中具有固定內容的容器](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents.md)
- [目錄概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [製作遊戲第 3 部分 - 撰寫程式碼](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-coding.md)
- [商店 (舊版 Economy)](/zh-TW/services/playfab/economy-monetization/economy/stores/index.md)
- [Economy v2 組合](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)