REST Resource: scores

리소스: GetLeaderboardScoresResponse

플레이어 리더보드 점수 목록입니다.

JSON 표현
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerLeaderboardScoreListResponse입니다.

nextPageToken

string

다음 결과 페이지를 위한 페이지로 나누기 토큰입니다.

player

object (Player)

이 점수 소유자의 플레이어 리소스입니다.

items[]

object (LeaderboardScore)

리더보드 점수입니다.

LeaderboardScore

플레이어 리더보드 점수 객체입니다.

JSON 표현
{
  "kind": string,
  "leaderboard_id": string,
  "scoreValue": string,
  "scoreString": string,
  "publicRank": {
    object (LeaderboardScoreRank)
  },
  "socialRank": {
    object (LeaderboardScoreRank)
  },
  "friendsRank": {
    object (LeaderboardScoreRank)
  },
  "timeSpan": enum (ScoreTimeSpan),
  "writeTimestamp": string,
  "scoreTag": string
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerLeaderboardScore입니다.

leaderboard_id

string

이 점수가 포함된 리더보드의 ID입니다.

scoreValue

string (int64 format)

이 점수의 숫자 값입니다.

scoreString

string

이 점수의 형식이 지정된 값입니다.

publicRank

object (LeaderboardScoreRank)

리더보드에 있는 점수의 공개 순위입니다. 사용자가 점수를 공개적으로 공유하지 않으면 이 객체가 표시되지 않습니다.

socialRank

object (LeaderboardScoreRank)

이 리더보드에서 점수의 소셜 순위입니다.

friendsRank

object (LeaderboardScoreRank)

이 리더보드의 친구 컬렉션 점수 순위입니다.

timeSpan

enum (ScoreTimeSpan)

이 점수의 기간입니다.

writeTimestamp

string (int64 format)

이 점수가 기록된 타임스탬프(UTC 기준 에포크 이후 밀리초)입니다.

scoreTag

string

점수에 대한 추가 정보입니다. 값은 RFC 3986의 2.3항에 정의된 URI 안전 문자를 64자 이하로 포함해야 합니다.

LeaderboardScoreRank

리더보드의 점수 순위

JSON 표현
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#leaderboardScoreRank입니다.

rank

string (int64 format)

리더보드에서의 순위입니다.

formattedRank

string

리더보드에서 문자열로 표시된 순위입니다.

numScores

string (int64 format)

리더보드의 점수 개수입니다.

formattedNumScores

string

리더보드에 문자열로 된 점수 개수입니다.

ScoreTimeSpan

점수에 사용할 수 있는 시간 범위를 정의합니다.

열거형
ALL_TIME 전체 누적 점수입니다.
WEEKLY 점수는 주간 점수입니다.
DAILY 점수는 일일 점수입니다.

메서드

get

현재 인증된 플레이어의 리더보드에서 최고점수 및 순위(선택사항)를 가져옵니다.

list

리더보드에 위에서부터 점수를 나열합니다.

listWindow

플레이어의 점수를 포함하여 그 주변을 리더보드에 표시합니다.

submit

지정된 리더보드에 점수를 제출합니다.

submitMultiple

리더보드에 여러 점수를 제출합니다.