> ## 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 回應中排行榜的大小。如果要求傳回 N 個項目，則計量會遞增 N/10 次 (無條件進位)。請注意，*N* 受要求參數和排行榜大小影響，且如果 N \< 10，計量會遞增一次。

以下是會讓此計量遞增的 API 清單：

| API 名稱 | API 參考 |
| - | - |
| GetFriendLeaderboardForEntity | [/rest/api/services/playfab/progression/leaderboards/get-friend-leaderboard-for-entity](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-friend-leaderboard-for-entity) |
| GetLeaderboard | [/rest/api/services/playfab/progression/leaderboards/get-leaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-leaderboard) |
| GetLeaderboardAroundEntity | [/rest/api/services/playfab/progression/leaderboards/get-leaderboard-around-entity](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-leaderboard-around-entity) |
| GetLeaderboardForEntities | [/rest/api/services/playfab/progression/leaderboards/get-leaderboard-for-entities](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-leaderboard-for-entities) |

## 排行榜寫入

更新獨立排行榜 (例如非以排名統計資料為基礎的排行榜) 上 N 個項目的要求，會讓排行榜計量遞增 N 次。對於以排名統計資料為基礎的排行榜，統計資料寫入和排行榜寫入計量都會受到影響。如需詳細資訊，請參閱統計資料寫入。

以下是會讓此計量遞增的 API 清單：

| API 名稱 | API 參考 |
| - | - |
| UpdateLeaderboardEntries | [/rest/api/services/playfab/progression/leaderboards/update-leaderboard-entries](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/update-leaderboard-entries) |

## 排行榜儲存體

此計量追蹤服務中儲存了多少排行榜資料。

對於每個排行榜項目，所耗用的儲存體計算為下列元素的總和：

* 分數：分數清單的長度乘以 `sizeof(long)`。
* 中繼資料：欄位的長度。
* 時間戳記：`sizeof(long)`。
* 實體識別碼的長度。

## 另請參閱

* [statistics-meters.md](/zh-TW/services/playfab/pricing/meters/statistics-meters)。


## Related topics

- [排行榜 API 參考](/zh-TW/services/playfab/community/leaderboards/api-reference.md)
- [排行榜配額](/zh-TW/services/playfab/community/leaderboards/quota-leaderboards.md)
- [統計資料計量](/zh-TW/services/playfab/pricing/meters/statistics-meters.md)
- [排行榜的限制](/zh-TW/services/playfab/community/leaderboards/limits-leaderboards.md)
- [排行榜快速入門](/zh-TW/services/playfab/community/leaderboards/quickstart-leaderboards.md)