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

# Leaderboards メーター

> PlayFab Leaderboards の課金メーターの仕組み、カウントされる操作、およびリーダーボードの利用がサービス料金にどのように寄与するかを学びます。

Leaderboards メーターは 3 つのカテゴリに分かれています。

## Leaderboard Reads

ランク付けされた統計に基づくかどうかにかかわらず、Leaderboard Reads は API レスポンス内のリーダーボードのサイズに依存します。リクエストで N 件のエントリが返された場合、メーターは切り上げで N/10 回インクリメントされます。なお、*N* はリクエスト パラメーターとリーダーボードのサイズに影響されます。また、N \< 10 の場合、メーターは 1 回インクリメントされます。

このメーターをインクリメントする 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)           |

## Leaderboard Writes

スタンドアロンのリーダーボード (たとえばランク付けされた統計に基づかないリーダーボード) 上で N 件のエントリを更新するリクエストは、Leaderboard メーターを N 回インクリメントします。ランク付けされた統計に基づくリーダーボードでは、Statistic Write と Leaderboards Write の両方のメーターに影響します。詳細については Statistic Write を参照してください。

このメーターをインクリメントする 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) |

## Leaderboard Storage

このメーターは、サービスに保存されているリーダーボード データの量を追跡します。

各リーダーボード エントリでは、消費されるストレージは以下の要素の合計として計算されます。

* Scores: スコア リストの長さと `sizeof(long)` の積。
* Metadata: フィールドの長さ。
* Timestamp: `sizeof(long)`。
* エンティティ ID の長さ。

## 関連項目

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


## Related topics

- [Statistics メーター](/ja-jp/services/playfab/pricing/meters/statistics-meters.md)
- [XblLeaderboardGetLeaderboardAsync](/ja-jp/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync.md)
- [PFLeaderboardsGetLeaderboardGetResult](/ja-jp/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardgetresult.md)
- [XblLeaderboardGetLeaderboardResult](/ja-jp/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardresult.md)
- [PFLeaderboardsGetLeaderboardAsync](/ja-jp/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardasync.md)