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에 정의된 대로 64자 이하의 URI 안전 문자를 포함해야 합니다.

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

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