Method: scores.get

현재 인증된 플레이어의 리더보드에서 최고점수와 원하는 경우 순위를 가져옵니다. 특정 기간의 경우 leaderboardId를 ALL로 설정하여 지정된 기간의 모든 리더보드 데이터를 검색할 수 있습니다. `참고: 동일한 요청에서 'ALL' 리더보드와 'ALL' 시간 범위를 요청할 수 없습니다. 하나의 매개변수만 'ALL'로 설정할 수 있습니다.

HTTP 요청

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

경로 매개변수

매개변수
playerId

string

플레이어 ID입니다. 인증된 플레이어의 ID 대신 me 값을 사용할 수 있습니다.
leaderboardId

string

리더보드의 ID입니다. 'ALL'로 설정하여 이 애플리케이션의 모든 리더보드 데이터를 가져올 수 있습니다.
timeSpan

enum (ScoreTimeSpan)

요청하는 점수 및 순위의 기간입니다.

쿼리 매개변수

매개변수
language

string

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

enum (IncludeRankType)

반환할 순위 유형입니다. 이 매개변수를 생략하면 순위가 반환되지 않습니다.
maxResults

integer

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

string

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

요청 본문

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

응답 본문

성공하면 응답 본문에 GetLeaderboardScoresResponse 인스턴스가 포함됩니다.

승인 범위

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

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

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

ScoreTimeSpan

점수에 가능한 기간을 정의합니다.

Enum
ALL 모든 기간의 최고 점수를 가져옵니다. 이 옵션을 사용하면 maxResults 값이 무시됩니다.
ALL_TIME 역대 최고 점수를 달성합니다.
WEEKLY 오늘의 최고 점수를 표시합니다.
DAILY 이번 주 최고 점수를 표시합니다.

IncludeRankType

순위 유형의 가능한 값입니다.

Enum
ALL 지원되는 모든 순위를 검색합니다. HTTP에서는 이 매개변수 값을 ALL로 지정할 수도 있습니다.
PUBLIC 플레이어가 게임플레이 활동을 공개적으로 공유하는 경우 공개 순위를 가져옵니다.
SOCIAL

(사용하지 않음) 소셜 순위를 가져옵니다.
FRIENDS 친구 컬렉션에서 순위를 가져옵니다.