> ## 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 目錄與庫存 API 的節流與速率限制參考，包括每位玩家與每個遊戲的每秒要求配額。

# 限制 - Economy (V2)

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

本指南旨在詳細說明在建立、更新及讀取物品目錄，以及在玩家庫存中新增、更新和移除物品時所強制執行的限制。現在已包含 Economy (V2) 的最新限制。

* 限制 (玩家) 是指目標實體為玩家時的限制。
* 限制 (遊戲) 是指目標實體為遊戲時的限制。

<Note>
  所有 API 都會分開計算。
</Note>

## 目錄節流

### 讀取

| **API** | **限制 (玩家)** | **限制 (遊戲)** |
| - | - | - |
| **GetItem** | 1.67 rps (60 秒內 100 次) | 1000 rps (10 秒內 10000 次) |
| **GetItems** | 1.67 rps (60 秒內 100 次) | 1000 rps (10 秒內 10000 次) |
| **SearchItems** | 1.67 rps (60 秒內 100 次) | 1000 rps (10 秒內 10000 次) |
| **GetItemReviews** | 1.67 rps (60 秒內 100 次) | 1000 rps (10 秒內 10000 次) |
| **GetItemReviewsSummary** | 1.67 rps (60 秒內 100 次) | 1000 rps (10 秒內 10000 次) |
| **GetEntityItemReview** | 1.67 rps (60 秒內 100 次) | 1000 rps (10 秒內 10000 次) |
| **GetItemModerationState** | - | 1000 rps (10 秒內 10000 次) |

### 寫入/管理

| **API** | **限制 (玩家)** | **限制 (遊戲)** |
| - | - | - |
| **CreateDraftItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **CreateUploadUrls** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **DeleteEntityItemReviews** | - | 100 rps (10 秒內 1000 次) |
| **DeleteItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **GetDraftItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **GetDraftItems** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **GetEntityDraftItems** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **GetItemPublishStatus** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **PublishDraftItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **ReportItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **ReportItemReview** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **ReviewItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **SetItemModerationState** | - | 100 rps (10 秒內 1000 次) |
| **SubmitItemReviewVote** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |
| **TakedownItemReviews** | - | 100 rps (10 秒內 1000 次) |
| **UpdateDraftItem** | 0.33 rps (30 秒內 10 次) | 100 rps (10 秒內 1000 次) |

## 庫存節流

<Note>
  * 庫存節流會依據目標實體，針對每個 API 個別計算。- 例如，如果玩家或遊戲 (遊戲服務、CloudScript 等) 呼叫庫存 API 來更新玩家實體的庫存，就會套用限制 (玩家) 節流。- 也支援[群組實體](/zh-TW/services/playfab/live-service-management/game-configuration/entities#group)庫存，且群組實體與玩家實體共用相同的節流速率。另請參閱[群組](/zh-TW/services/playfab/community/associations/groups)。
</Note>

### 讀取

| **API** | **限制 (玩家)** | **限制 (遊戲)** |
| - | - | - |
| **GetInventoryItems** | 0.67 rps (60 秒內 40 次) | - |
| **GetInventoryCollectionIds** | 0.08 rps (60 秒內 5 次) | - |

### 讀取交易記錄

| **API** | **限制 (玩家)** | **限制 (遊戲)** |
| - | - | - |
| **GetTransactionHistory** | 0.1 rps (300 秒內 30 次) | - |

### 寫入

| **API** | **限制 (玩家)** | **限制 (遊戲)** |
| - | - | - |
| **AddInventoryItems** | 0.33 rps (60 秒內 20 次) | - |
| **SubtractInventoryItems** | 0.33 rps (60 秒內 20 次) | - |
| **UpdateInventoryItems** | 0.33 rps (60 秒內 20 次) | - |
| **PurchaseInventoryItems** | 0.33 rps (60 秒內 20 次) | - |
| **TransferInventoryItems** | 0.33 rps (60 秒內 20 次) | - |
| **DeleteInventoryItems** | 0.33 rps (60 秒內 20 次) | - |
| **ExecuteInventoryOperations** | 0.33 rps (60 秒內 20 次) | - |
| **DeleteInventoryCollection** | 0.08 rps (60 秒內 5 次) | - |

### 兌換

| **API** | **限制 (玩家)** | **限制 (遊戲)** |
| - | - | - |
| **RedeemAppleAppStoreInventoryItems** | 0.16 rps (60 秒內 10 次) | - |
| **RedeemGooglePlayInventoryItems** | 0.16 rps (60 秒內 10 次) | - |
| **RedeemMicrosoftStoreInventoryItems** | 0.16 rps (60 秒內 10 次) | - |
| **RedeemNintendoEShopInventoryItems** | 0.16 rps (60 秒內 10 次) | - |
| **RedeemPlayStationStoreInventoryItems** | 0.16 rps (60 秒內 10 次) | - |
| **RedeemSteamInventoryItems** | 0.16 rps (60 秒內 10 次) | - |

## API 限制

### 二進位內容大小

允許的檔案大小上限為 **500MB**。

### 二進位內容數量

每個物品最多可新增 **100 張影像**和 **100 個檔案**。

* 檔案沒有任何限制。
* 影像只能使用 **.png**、**.jpg**、**.gif** 或 **.bmp** 檔案類型上傳。

### CreateUploadsUrls

內容 Blob/URL 若**未**附加至草稿或已發佈的物品，將在 **24 小時**後進行記憶體回收。

### 目錄頁面大小上限

以下是各個 API 傳回的物品數量上限。您可以使用[接續權杖](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens)，分頁瀏覽傳回數量超過上限的結果。

* `SearchItems` - 每頁 50 個物品
* `GetItems` - 每頁 50 個物品
* `GetItemReviews` - 每頁 50 個物品
* `GetItemContainers` - 每頁 50 個物品
* `GetEntityDraftItems` - 每頁 50 個物品

### 目錄預設頁面大小

* `SearchItems` - 每頁 10 個物品
* `GetItems` - 每頁 10 個物品
* `GetItemReviews` - 每頁 10 個物品
* `GetItemContainers` - 每頁 10 個物品
* `GetDraftItems` - 每頁 10 個物品
* `GetEntityDraftItems` - 每頁 10 個物品

### 庫存頁面大小上限

以下是各個 API 傳回的物品數量上限。您可以使用[接續權杖](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens)，分頁瀏覽傳回數量超過上限的結果。

| **API** | **使用回應壓縮時的限制** | **未使用回應壓縮時的限制** |
| - | - | - |
| **GetInventoryItems** | 250 個物品 | 50 個物品 |
| **GetInventoryCollectionIds** | 250 個物品 | 50 個物品 |
| **GetTransactionHistory** | 250 個物品 | 50 個物品 |

### 庫存預設頁面大小

* `GetInventoryItems` - 每頁 10 個物品
* `GetInventoryCollectionIds` - 每頁 10 個物品
* `GetTransactionHistory` - 每頁 10 個物品

### 搜尋篩選複雜度

系統會強制執行檢查，以防止在 `SearchItems` 呼叫中使用過於複雜的 `Filter` 查詢。如需詳細資訊，請參閱[這裡](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/search#limits)。

## 目錄物品

### 目錄建立者實體限制

每個目錄建立者實體最多允許 20GB 的目錄資料。由遊戲實體建立的目錄物品最有可能遇到此限制。

### 標題

每個國家/地區代碼的標題有 **512 個字元的限制**。

### 描述

每個國家/地區代碼的描述有 **10000 個字元的限制**。

### 關鍵字

每個關鍵字有 **50 個字元的限制**，每個國家/地區代碼最多可新增 **32 個關鍵字**。

### 顯示屬性

顯示屬性欄位有 **10000 位元組的限制**。

### 標籤

每個標籤有 **32 個字元的限制**。
遊戲最多可擁有 **1024 個標籤**，且
每個物品最多可新增 **32 個標籤**

### 內容類型

每個內容類型有 **32 個字元的限制**。
遊戲最多可擁有 **128 個內容類型**。

### PricesOptions

價格選項清單的長度限制為 **15 個價格選項**。

### Amounts

數量清單的長度限制為 **15 個數量**。

### UnitDurationInSeconds

單位持續時間的限制為 **100 年** (3,155,695,200 秒)。

### AlternateIds

每個替代 ID 的值長度限制為 **100 個字元**。

替代 ID 的清單長度限制為 **15 個替代 ID**。

### DisplayVersion

顯示版本欄位的值長度限制為 **50 個字元**。

### ClientVersion

用戶端版本有 **3 個區段的限制**，每個區段允許的最大值為 **65535**。\
例如："1.65535.234"。

### ItemReferences

ItemReferences 欄位的限制為 **250 個物品**。

## 目錄設定

### AdminEntities

管理實體清單有 **64 個實體的限制**。

### ReviewerEntities

管理實體清單有 **128 個實體的限制**。

### 深層連結

深層連結的數量上限為 **10 個連結**。

### DisplayPropertyIndexInfo

每種顯示屬性類型有 **5 個值**的限制。

### 內容類型

內容類型清單的限制為 **128 種類型**，每種類型的長度上限為 **40 個字元**。

### 平台

平台清單的限制為 **128 個平台**，每個平台的長度上限為 **40 個字元**。

### 標籤

標籤清單的限制為 **1024 個標籤**，每個標籤的長度上限為 **32 個字元**。

## 玩家庫存

### 批次作業

要執行的庫存作業數量上限為 **50 個作業**。

要修改的物品數量上限為 **300 個物品**。\
(例如，您可以新增一個完整的組合包以及最多 50 個其他物品)

### 庫存集合

集合大小上限為 **10000 個物品**。

每個實體的集合清單長度限制為 **1000 個集合**。

集合名稱的字元限制為 **75 個字元**。

### 交易記錄

交易記錄的日期範圍上限為 **4 年**。

預設日期範圍為**六個月**。

## 庫存物品

### 顯示屬性

顯示屬性欄位有 1000 位元組的限制。


## Related topics

- [節流最佳做法](/zh-TW/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [PlayFab 中的節流](/zh-TW/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [Economy v2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview.md)
- [Economy V2 TurboLoading](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)
- [Economy v2 設定概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/settings.md)