限制 - Economy (V2)

Economy v2 现已正式发布。如需支持和反馈，请访问 PlayFab 论坛。

本指南的目的是详细说明在创建、更新和读取物品目录，以及将物品添加、更新和从玩家库存中移除时所实施的限制。它现在包括根据 Economy (V2) 更新的最新限制。

Limit (Player) 指目标实体为玩家时的情况。
Limit (Title) 指目标实体为游戏时的情况。

所有 API 彼此分别计数。

目录限流

读取

API	Limit (Player)	Limit (Title)
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	Limit (Player)	Limit (Title)
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 个）

库存限流

库存限流将基于目标实体，为每个 API 单独计算。- 例如，如果玩家或游戏（游戏服务、CloudScript 等）调用库存 API 来更新玩家实体的库存，将应用 Limit (Player) 限流。- 也支持 Group 实体库存，并且 Group 实体与玩家实体共享相同的限流速率。另请参见 Groups。

读取

API	Limit (Player)	Limit (Title)
GetInventoryItems	0.67 rps（60 秒内 40 个）	-
GetInventoryCollectionIds	0.08 rps（60 秒内 5 个）	-

读取交易历史

API	Limit (Player)	Limit (Title)
GetTransactionHistory	0.1 rps（300 秒内 30 个）	-

写入

API	Limit (Player)	Limit (Title)
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	Limit (Player)	Limit (Title)
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 返回的物品最大数量。你可以使用延续令牌分页浏览超出限制的结果。

SearchItems - 每页 50 个物品
GetItems - 每页 50 个物品
GetItemReviews - 每页 50 个物品
GetItemContainers - 每页 50 个物品
GetEntityDraftItems - 每页 50 个物品

目录默认页面大小

SearchItems - 每页 10 个物品
GetItems - 每页 10 个物品
GetItemReviews - 每页 10 个物品
GetItemContainers - 每页 10 个物品
GetDraftItems - 每页 10 个物品
GetEntityDraftItems - 每页 10 个物品

库存最大页面大小

以下是各种 API 返回的物品最大计数。你可以使用延续令牌分页浏览超过限制的结果。

API	响应压缩时的限制	无响应压缩时的限制
GetInventoryItems	250 个物品	50 个物品
GetInventoryCollectionIds	250 个物品	50 个物品
GetTransactionHistory	250 个物品	50 个物品

库存默认页面大小

GetInventoryItems - 每页 10 个物品
GetInventoryCollectionIds - 每页 10 个物品
GetTransactionHistory - 每页 10 个物品

搜索过滤器复杂度

对 SearchItems 调用中使用的 Filter 查询实施检查以防止使用过于复杂的查询。更多信息可以在此处找到。

目录物品

目录创建者实体限制

每个目录创建者实体最多允许 20GB 的目录数据。此限制最可能是在由 Title 实体创建的目录物品中遇到。

Title

每个国家/地区代码的 Title 有 512 字符限制。

Description

每个国家/地区代码的 Description 有 10000 字符限制。

Keywords

每个关键词有 50 字符限制，每个国家/地区代码最多可添加 32 个关键词。

Display Properties

Display Properties 字段有 10000 字节限制。

内容类型

每个内容类型有 32 字符限制。 Titles 最多可以有 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 字符。

玩家库存

批处理操作

要执行的库存操作最大数量为 50 个操作。要修改的物品最大数量为 300 个物品。（例如，你可以添加一个完整的捆绑包和最多 50 个其他物品）

库存集合

最大集合大小为 10000 个物品。每个实体的集合列表长度限制为 1000 个集合。集合名称的字符限制为 75 字符。

交易历史

交易历史的最大日期范围为 4 年。默认日期范围为 六个月。

库存物品

Display Properties

Display Properties 字段有 1000 字节限制。

​限制 - Economy (V2)

​目录限流

​读取

​写入/管理

​库存限流

​读取

​读取交易历史

​写入

​兑换

​API 限制

​二进制内容大小

​二进制内容数量

​CreateUploadsUrls

​目录最大页面大小

​目录默认页面大小

​库存最大页面大小

​库存默认页面大小

​搜索过滤器复杂度

​目录物品

​目录创建者实体限制

​Title

​Description

​Keywords

​Display Properties

​Tags

​内容类型

​PricesOptions

​Amounts

​UnitDurationInSeconds

​AlternateIds

​DisplayVersion

​ClientVersion

​ItemReferences

​目录配置

​AdminEntities

​ReviewerEntities

​深度链接

​DisplayPropertyIndexInfo

​内容类型

​平台

​标签

​玩家库存

​批处理操作

​库存集合

​交易历史

​库存物品

​Display Properties

限制 - Economy (V2)

目录限流

读取

写入/管理

库存限流

读取

读取交易历史

写入

兑换

API 限制

二进制内容大小

二进制内容数量

CreateUploadsUrls

目录最大页面大小

目录默认页面大小

库存最大页面大小

库存默认页面大小

搜索过滤器复杂度

目录物品

目录创建者实体限制

Title

Description

Keywords

Display Properties

Tags

内容类型

PricesOptions

Amounts

UnitDurationInSeconds

AlternateIds

DisplayVersion

ClientVersion

ItemReferences

目录配置

AdminEntities

ReviewerEntities

深度链接

DisplayPropertyIndexInfo

内容类型

平台

标签

玩家库存

批处理操作

库存集合

交易历史

库存物品

Display Properties