Method: scores.listWindow

플레이어 점수 주변의 리더보드에 점수를 나열합니다.

HTTP 요청

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

경로 매개변수

매개변수
leaderboardId

string

리더보드의 ID입니다.
collection

enum (ScoreCollection)

요청하는 점수의 모음입니다.

쿼리 매개변수

매개변수
language

string

이 메서드에서 반환하는 문자열에 사용할 기본 언어입니다.
timeSpan

enum (ScoreTimeSpan)

필수 항목입니다. 요청하는 점수 및 순위에 해당하는 기간입니다.
maxResults

integer

응답에서 반환할 리더보드 점수의 최대 개수입니다. 모든 응답의 경우 반환되는 실제 리더보드 점수의 수는 지정된 maxResults보다 적을 수 있습니다.
resultsAbove

integer

플레이어의 점수보다 높게 반환할 선호 점수 수입니다. 플레이어가 리더보드의 하단에 있으면 더 많은 점수가 반환될 수 있으며, 플레이어가 최상위에 있으면 더 적은 점수가 반환될 수도 있습니다. maxResults 이하여야 합니다.
returnTopIfAbsent

boolean

플레이어가 리더보드에 없을 때 최고 점수를 반환해야 하는 경우 true입니다. 기본값은 true입니다.
pageToken

string

이전 요청에서 반환된 토큰입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 ListLeaderboardScoresResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

자세한 내용은 OAuth 2.0 개요를 참고하세요.