Method: scores.get

현재 인증된 플레이어의 리더보드에서 최고 점수 및 원하는 경우 순위를 가져옵니다. 특정 기간 동안 leaderboardId를 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

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

열거형
ALL 전체 기간의 최고 점수를 확인합니다. 이를 사용하면 maxResults 값이 무시됩니다.
ALL_TIME 사상 최고 점수를 받아 보세요.
WEEKLY 당일의 최고 점수를 나열합니다.
DAILY 이번 주의 최고 점수를 나열합니다.

IncludeRankType

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

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

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