跳轉到主要內容

限制 - Economy (V2)

Economy v2 現已正式推出。如需支援與意見反應,請前往 PlayFab 論壇。
本指南旨在詳細說明在建立、更新及讀取物品目錄,以及在玩家庫存中新增、更新和移除物品時所強制執行的限制。現在已包含 Economy (V2) 的最新限制。
  • 限制 (玩家) 是指目標實體為玩家時的限制。
  • 限制 (遊戲) 是指目標實體為遊戲時的限制。
所有 API 都會分開計算。

目錄節流

讀取

寫入/管理

庫存節流

  • 庫存節流會依據目標實體,針對每個 API 個別計算。- 例如,如果玩家或遊戲 (遊戲服務、CloudScript 等) 呼叫庫存 API 來更新玩家實體的庫存,就會套用限制 (玩家) 節流。- 也支援群組實體庫存,且群組實體與玩家實體共用相同的節流速率。另請參閱群組。

讀取

讀取交易記錄

寫入

兌換

API 限制

二進位內容大小

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

二進位內容數量

每個物品最多可新增 100 張影像和 100 個檔案。
  • 檔案沒有任何限制。
  • 影像只能使用 .png、.jpg、.gif 或 .bmp 檔案類型上傳。

CreateUploadsUrls

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

目錄頁面大小上限

以下是各個 API 傳回的物品數量上限。您可以使用接續權杖,分頁瀏覽傳回數量超過上限的結果。
  • SearchItems - 每頁 50 個物品
  • GetItems - 每頁 50 個物品
  • GetItemReviews - 每頁 50 個物品
  • GetItemContainers - 每頁 50 個物品
  • GetEntityDraftItems - 每頁 50 個物品

目錄預設頁面大小

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

庫存頁面大小上限

以下是各個 API 傳回的物品數量上限。您可以使用接續權杖,分頁瀏覽傳回數量超過上限的結果。

庫存預設頁面大小

  • GetInventoryItems - 每頁 10 個物品
  • GetInventoryCollectionIds - 每頁 10 個物品
  • GetTransactionHistory - 每頁 10 個物品

搜尋篩選複雜度

系統會強制執行檢查,以防止在 SearchItems 呼叫中使用過於複雜的 Filter 查詢。如需詳細資訊,請參閱這裡。

目錄物品

目錄建立者實體限制

每個目錄建立者實體最多允許 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 位元組的限制。
最後修改於 2026年10月6日