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

# 排行榜的限制

> 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` 的排行榜。

## 另请参阅

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