> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Ranking API リファレンス

ランキング機能




**⚠️ Warning**

GS2-Ranking2 がリリースされました。

特別な理由がない限りは新しく利用する場合は [GS2-Ranking2]() を利用してください。

スコアやクリアタイムのランキング処理を実現します。

ランキングには全員が同じデータを参照するグローバルランキングと、<br>
フレンド間やギルド内のランキングのようなユーザーによって見えるランキングの内容の異なるスコープドランキングがあります。

グローバルランキングは、15分～24時間の間で指定した間隔でランキングの集計処理がおこなわれ、<br>
ゲームユーザーからのリクエストは事前に集計された結果を応答します。<br>
これによって、大量のゲームプレイヤーが居たとしてもレスポンスタイムは変わらないように設計されています。

スコープドランキングは各ゲームプレイヤーがスコアバケットをもち、購読しているゲームプレイヤーがスコアを登録するとスコアバケットにスコアが追加されます。<br>
各ゲームプレイヤーは自分のスコアバケット内のスコアを使ってランキングを処理します。

グローバルランキング・スコープドランキング ともにユーザーID毎に保持できるスコアを1個にするか、複数保持できるかを設定できます。<br>
ランキングを登録したときに最後に登録したスコアだけをランキング対象としたいか、登録したすべてのスコアをランキング対象としたいかで設定できます。<br>
すべてのスコアをランキング対象とする場合、データ量が膨れ上がりやすくなります。その結果、GS2の利用料金にも影響を与えることとなります。<br>
ゲームシステム上の大きな理由がなければ最後に登録された1つのスコアのみがランキング対象となるように設定することをお勧めします。

[マイクロサービス紹介 / GS2-Ranking](../../microservices/ranking)




- [GS2-Ranking Deploy/CDK リファレンス](/ja/api_reference/ranking/deploy/)
  
- [GS2-Ranking SDK API リファレンス](/ja/api_reference/ranking/sdk/)
  
- [GS2-Ranking SDK for Game Engine API リファレンス](/ja/api_reference/ranking/game_engine/)
  
- [GS2-Ranking マスターデータリファレンス](/ja/api_reference/ranking/master_data/)