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

# GS2-Ranking2 API リファレンス

ランキング機能




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

GS2-Ranking2 は、グローバルランキング・クラスターランキング・購読ランキングの3種類を提供します。

- グローバルランキングはスコアを即時に反映し、上位1,000人だけをランキングとして保持します。それより下位のプレイヤーは圏外として扱われます。
- クラスターランキングは、ギルドIDなどのクラスターIDごとに個別のランキングを作成します。スコア登録時に、プレイヤーが対象のクラスターへ所属していることを検証することもできます。
- 購読ランキングは、プレイヤーが購読した他プレイヤーのスコアから個別のランキングを構成し、フレンド内ランキングのような非対称な関係に利用できます。スコアは非同期で反映され、通常は1秒以内に更新されます。

ランキングには GS2-Schedule のイベントをシーズンとして関連づけられます。<br>
イベントの繰り返しごとに新しいシーズンを開始して過去の結果を保持し、順位の閾値に応じた報酬を設定できます。

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

**Tip**

GS2-Ranking2 は名前の通りバージョン2に相当するマイクロサービスです。

以前のバージョンに関するドキュメントは [GS2-Ranking]() を参照してください。




- [GS2-Ranking2 Deploy/CDK リファレンス](/ja/api_reference/ranking2/deploy/)
  
- [GS2-Ranking2 SDK API リファレンス](/ja/api_reference/ranking2/sdk/)
  
- [GS2-Ranking2 SDK for Game Engine API リファレンス](/ja/api_reference/ranking2/game_engine/)
  
- [GS2-Ranking2 トランザクションアクション](/ja/api_reference/ranking2/stamp_sheet/)
  
- [GS2-Ranking2 マスターデータリファレンス](/ja/api_reference/ranking2/master_data/)