> ## 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) 更新的最新限制。

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

<Note>
  所有 API 彼此分别计数。
</Note>

## 目录限流

### 读取

| **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 实体](/services/playfab/live-service-management/game-configuration/entities#group) 库存，并且 Group 实体与玩家实体共享相同的限流速率。另请参见 [Groups](/services/playfab/community/associations/groups)。
</Note>

### 读取

| **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 返回的物品最大数量。你可以使用 [延续令牌](/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 返回的物品最大计数。你可以使用 [延续令牌](/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` 查询实施检查以防止使用过于复杂的查询。更多信息可以在[此处](/services/playfab/economy-monetization/economy-v2/catalog/search#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

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