> 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 레퍼런스](/ko/api_reference/ranking/deploy/)
  
- [GS2-Ranking SDK API 레퍼런스](/ko/api_reference/ranking/sdk/)
  
- [GS2-Ranking SDK for Game Engine API 레퍼런스](/ko/api_reference/ranking/game_engine/)
  
- [GS2-Ranking 마스터 데이터 레퍼런스](/ko/api_reference/ranking/master_data/)