> ## 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 Leaderboards 服務的速率限制和各 API 要求配額，涵蓋建立、讀取和更新呼叫中針對呼叫者和目標實體的節流。

本指南的目的是詳細說明在 Leaderboards 服務上建立、更新及讀取排行榜時所強制執行的限制。

* 呼叫者：此類型的限制會強制套用於 API 的呼叫者。此限制條件可能是玩家或遊戲。
* 目標：此類型的限制會強制套用於 API 的目標，在我們的特定案例中是實體。

下表概述 Leaderboards 服務中各種可用 API 的限制。如果此處未明確列出某個 API，則會套用預設行為。

| API | 限制 | 呼叫者 | 目標實體 |
| - | - | - | - |
| 預設 | 每 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` 的排行榜。

## 另請參閱

* [建立基本排行榜](/zh-TW/services/playfab/community/leaderboards/create-basic-leaderboard)
* [使用排行榜執行更多操作](/zh-TW/services/playfab/community/leaderboards/doing-more-with-leaderboards)
* [季節性排行榜](/zh-TW/services/playfab/community/leaderboards/seasonal-leaderboards)
* [配額 ](/zh-TW/services/playfab/community/leaderboards/quota-leaderboards)
* [群組排行榜](/zh-TW/services/playfab/community/leaderboards/group-leaderboards)
* [手動層級](/zh-TW/services/playfab/community/leaderboards/manual-tiers)
* [依統計資料為玩家排名](/zh-TW/services/playfab/community/leaderboards/leaderboards-linked-to-stats)
* [將內容相關資料新增至排行榜](/zh-TW/services/playfab/community/leaderboards/metadata-leaderboards)
* [API 參考](/zh-TW/services/playfab/community/leaderboards/api-reference)
* [排行榜計量](/zh-TW/services/playfab/pricing/meters/leaderboard-meters)
* [排行榜與 Cloudscript](/zh-TW/services/playfab/community/leaderboards/leaderboards-cloudscript)。
* [排行榜與 Playstream](/zh-TW/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [排行榜與 PlayStream 和 Telemetry](/zh-TW/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)
- [排行榜配額](/zh-TW/services/playfab/community/leaderboards/quota-leaderboards.md)
- [季節性排行榜](/zh-TW/services/playfab/community/leaderboards/seasonal-leaderboards.md)
- [事件型排行榜的範例程式碼](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-leaderboards-eb-howto.md)
- [事件型排行榜的入口網站設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-eb-leaderboards-portal.md)