REST Resource: scores

Recurso: GetLeaderboardScoresResponse

Uma lista de pontuações de placares de jogadores.

Representação JSON
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerLeaderboardScoreListResponse.

nextPageToken

string

O token de paginação para a próxima página de resultados.

player

object (Player)

Os recursos do jogador para o proprietário dessa pontuação.

items[]

object (LeaderboardScore)

As pontuações do placar.

LeaderboardScore

Um objeto de pontuação do placar do jogador.

Representação 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
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerLeaderboardScore.

leaderboard_id

string

O ID da tabela de classificação em que a pontuação está.

scoreValue

string (int64 format)

O valor numérico dessa pontuação.

scoreString

string

O valor formatado dessa pontuação.

publicRank

object (LeaderboardScoreRank)

A classificação pública da pontuação nessa tabela. Esse objeto não vai estar presente se o usuário não estiver compartilhando as pontuações publicamente.

socialRank

object (LeaderboardScoreRank)

A classificação social da pontuação no placar.

friendsRank

object (LeaderboardScoreRank)

A classificação da pontuação na coleção de amigos para este ranking.

timeSpan

enum (ScoreTimeSpan)

O período de tempo dessa nota.

writeTimestamp

string (int64 format)

O carimbo de data/hora em que a nota foi registrada, em milissegundos desde a época no UTC.

scoreTag

string

Informações adicionais sobre a pontuação. Os valores não podem conter mais de 64 caracteres seguros para URI, conforme definido na seção 2.3 do RFC 3986.

LeaderboardScoreRank

Uma classificação de pontuação em um placar.

Representação JSON
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#leaderboardScoreRank.

rank

string (int64 format)

A classificação no ranking.

formattedRank

string

A classificação no ranking como uma string.

numScores

string (int64 format)

O número de pontuações no placar.

formattedNumScores

string

O número de pontuações na tabela de classificação como uma string.

ScoreTimeSpan

Define os possíveis períodos de uma pontuação.

Enumerações
ALL_TIME A pontuação é a melhor de todos os tempos.
WEEKLY A pontuação é semanal.
DAILY A pontuação é diária.

Métodos

get

Receber pontuações altas e, opcionalmente, classificações nos placares do jogador autenticado.

list

Lista as pontuações em um placar, começando pela parte de cima.

listWindow

Lista as pontuações em um placar em torno (e incluindo) a pontuação de um jogador.

submit

Envia uma pontuação para a tabela de classificação especificada.

submitMultiple

Envia várias pontuações para os placares.