> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy V2 限制

> PlayFab Economy v2 目录和库存 API 的限流和速率限制参考，包括按玩家和按游戏的每秒请求配额。

> [!NOTE]
>
> Economy v2 现已正式发布。如需支持和反馈，请访问 [PlayFab 论坛](https://community.playfab.com)。

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

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

> [!NOTE]
>
> 所有 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 个） |

## 库存限流

> [!NOTE]
>
> * 库存限流将基于目标实体，为每个 API 单独计算。- 例如，如果玩家或游戏（游戏服务、CloudScript 等）调用库存 API 来更新玩家实体的库存，将应用 Limit (Player) 限流。- 也支持 [Group 实体](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/entities.md#group) 库存，并且 Group 实体与玩家实体共享相同的限流速率。另请参见 [Groups](https://docs.xbox.com/zh-CN/services/playfab/community/associations/groups.md)。

### 读取

| **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 返回的物品最大数量。你可以使用 [延续令牌](https://docs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/search.md#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 返回的物品最大计数。你可以使用 [延续令牌](https://docs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/search.md#continuation-tokens) 分页浏览超过限制的结果。

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

### 库存默认页面大小

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

### 搜索过滤器复杂度

对 `SearchItems` 调用中使用的 `Filter` 查询实施检查以防止使用过于复杂的查询。更多信息可以在[此处](https://docs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/search.md#limits)找到。

## 目录物品

### 目录创建者实体限制

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

### Title

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

### Description

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

### Keywords

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

### Display Properties

Display Properties 字段有 **10000 字节限制**。

### Tags

每个标签有 **32 字符限制**。
Titles 最多可以有 **1024 个标签**，
一个物品最多可以添加 **32 个标签**。

### 内容类型

每个内容类型有 **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 字符**。

### 标签

标签列表限制为 **1024 个标签**，每个最大长度为 **32 字符**。

## 玩家库存

### 批处理操作

要执行的库存操作最大数量为 **50 个操作**。

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

### 库存集合

最大集合大小为 **10000 个物品**。

每个实体的集合列表长度限制为 **1000 个集合**。

集合名称的字符限制为 **75 字符**。

### 交易历史

交易历史的最大日期范围为 **4 年**。

默认日期范围为 **六个月**。

## 库存物品

### Display Properties

Display Properties 字段有 1000 字节限制。


## Related topics

- [限流最佳实践](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [PlayFab 中的限流](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [Economy v2 概览](https://docs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/overview.md)
- [Economy V2 TurboLoading](https://docs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)
- [Economy v2 设置概览](https://docs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/settings.md)