限制 - Economy (V2)
重要
Economy v2 现已正式发布。 有关支持和反馈，请转到 PlayFab 论坛。
本指南的目的是详细说明在创建、更新和读取项目目录以及从玩家物品栏中添加、更新和删除它们时强制实施的限制。 它现在包括根据 Economy (V2) 的最新限制。
- 限制（玩家）是指目标实体是玩家时。
- 限制（游戏）是指目标实体是游戏时。
注意
所有 API 将会彼此分开计数。
目录限制
读取
| 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) |
物品栏限制
注意
读取
| API | 限制 (玩家) | 限制 (游戏) |
|---|---|---|
| GetInventoryItems | 1.67 rps (60 秒 100) | - |
| GetInventoryCollectionIds | 1.67 rps (60 秒 100) | - |
读取交易历史记录
| API | 限制 (玩家) | 限制 (游戏) |
|---|---|---|
| GetTransactionHistory | 0.1 rps (300 秒 30) | - |
写入
| API | 限制 (玩家) | 限制 (游戏) |
|---|---|---|
| AddInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| SubtractInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| UpdateInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| PurchaseInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| TransferInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| DeleteInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| ExecuteInventoryOperations | 0.66 rps (90 秒内 60 次) | - |
| DeleteInventoryCollection | 0.16 rps (90 秒 15) | - |
兑换
| API | 限制 (玩家) | 限制 (游戏) |
|---|---|---|
| RedeemAppleAppStoreInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| RedeemGooglePlayInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| RedeemMicrosoftStoreInventorItems | 0.66 rps (90 秒内 60 次) | - |
| RedeemNintendoEShopInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| RedeemPlayStationStoreInventoryItems | 0.66 rps (90 秒内 60 次) | - |
| RedeemSteamInventoryItems | 0.66 rps (90 秒内 60 次) | - |
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 查询。 可在此处找到更多信息。
目录项
游戏
每个国家/地区代码的磁贴限制为 512 个字符。
说明
每个国家/地区代码的说明限制为 10000 个字符。
Keywords
每个关键字限制为 50 个字符，每个国家/地区代码最多可以添加 32 个关键字。
显示属性
显示属性字段限制为 10000 字节。
标记
每个标记限制为 32 个字符。 游戏最多可以有 1024 个标记，最多可以向项添加 32 个标记
内容类型
每个内容类型限制为 32 个字符。 游戏最多可以有 128 种内容类型。
PricesOptions
价格选项列表的长度限制为 15 个价格选项。
金额
金额列表的长度限制为 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 项。
(例如，最多可以添加五个完整捆绑包，因为 5*50 = 250 与 250 的限制匹配)
库存集合
最大集合大小为 10000 个项目。
集合列表的长度限制为无限制。
集合名称的字符限制为 75 个字符。
交易历史记录
交易历史记录的最大日期范围为无限制。
默认日期范围为六个月。
物品栏项目
显示属性
显示属性字段限制为 1000 字节。