> ## 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.

# 排行榜的限制

> PlayFab 排行榜服务的速率限制和每个 API 请求配额，涵盖创建、读取和更新调用中的调用方及目标实体节流。

本指南的目的是详细介绍在排行榜服务上创建、更新和读取排行榜时强制执行的限制。

* 调用方：这种类型的限制针对 API 的调用方强制执行。此约束可能是玩家或标题。
* 目标：这种类型的限制针对 API 的目标强制执行，在我们的具体情况下即实体。

下表概述了排行榜服务中提供的各种 API 的限制。如果某个 API 未在此明确列出，则适用默认行为。

| API | 限制 | 调用方 | 目标实体 |
| - | - | - | - |
| Default | 每 120 秒 50 个请求 | 玩家 | `title_player_account` , `master_player_account`, `group`, `character` |
| GetLeaderboard | 每 120 秒 30 个请求 / 每 120 秒 1,200 个请求 | 玩家 / 标题 | 不适用 |
| GetLeaderboardAroundEntity | 每 120 秒 30 个请求 | 玩家 | `title_player_account`, `master_player_account` , `group`, `character` |
| GetFriendLeaderboardForEntity | 每 120 秒 30 个请求 | 玩家 | `title_player_account`, `master_player_account` , `group`, `character` |
| GetLeaderboardDefinition | 每 120 秒 30 个请求 | 标题 | 不适用 |
| ListLeaderboardDefinitions | 每 120 秒 30 个请求 | 标题 | 不适用 |
| CreateLeaderboardDefinition | 每 120 秒 30 个请求 | 标题 | 不适用 |
| UnlinkLeaderboardFromStatistic | 每 120 秒 30 个请求 | 标题 | 不适用 |
| IncrementLeaderboardVersion | 2 分钟内 30 个请求 | 标题 | 不适用 |

## 排行榜事件的限制

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended`
  * 仅返回排名前 1000 名。
  * 不适用于实体类型为 `master_player_account` 或 `external` 的排行榜。

## 另请参阅

* [创建基本排行榜](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/create-basic-leaderboard.md)
* [排行榜的更多用法](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/doing-more-with-leaderboards.md)
* [季节性排行榜](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/seasonal-leaderboards.md)
* [配额 ](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/quota-leaderboards.md)
* [组排行榜](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/group-leaderboards.md)
* [手动分级](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/manual-tiers.md)
* [按统计信息对玩家排名](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/leaderboards-linked-to-stats.md)
* [向排行榜添加上下文数据](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/metadata-leaderboards.md)
* [API 参考](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/api-reference.md)
* [排行榜计量表](https://docs.xbox.com/zh-CN/services/playfab/pricing/meters/leaderboard-meters.md)
* [排行榜与 CloudScript](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/leaderboards-cloudscript.md)。
* [排行榜与 PlayStream](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)


## Related topics

- [排行榜与 PlayStream 和遥测](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)
- [排行榜的更多用法](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/doing-more-with-leaderboards.md)
- [组排行榜](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/group-leaderboards.md)
- [配额排行榜](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/quota-leaderboards.md)
- [季节性排行榜](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/seasonal-leaderboards.md)