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

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

Enum
ALL_TIME 점수는 역대 점수입니다.
WEEKLY 점수는 주간 점수입니다.
DAILY 점수는 일일 점수입니다.

메서드

get

현재 인증된 플레이어의 리더보드에서 최고점수와 원하는 경우 순위를 가져옵니다.

list

리더보드에 점수를 표시합니다(상단부터).

listWindow

리더보드에 플레이어의 점수와 그 주변의 점수를 표시합니다.

submit

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

submitMultiple

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