REST Resource: scores

Recurso: GetLeaderboardScoresResponse

Uma lista de pontuações no placar dos jogadores.

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

string

Identifica exclusivamente o tipo deste 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 de jogadores.

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 deste recurso. O valor é sempre a string fixa games#playerLeaderboardScore.

leaderboard_id

string

O ID do placar em que a pontuação está.

scoreValue

string (int64 format)

O valor numérico da pontuação.

scoreString

string

O valor formatado dessa pontuação.

publicRank

object (LeaderboardScoreRank)

A classificação pública da pontuação neste quadro de liderança. Este objeto não 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 quadro de liderança.

timeSpan

enum (ScoreTimeSpan)

O período dessa pontuação.

writeTimestamp

string (int64 format)

O carimbo de data/hora em que essa pontuação foi registrada, em milissegundos, desde o período em UTC.

scoreTag

string

Informações adicionais sobre a pontuação. Os valores não podem conter mais do que 64 caracteres seguros para URI, conforme definido pela seção 2.3 da 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 deste recurso. O valor é sempre a string fixa games#leaderboardScoreRank.

rank

string (int64 format)

A classificação no quadro de liderança.

formattedRank

string

A classificação no placar como uma string.

numScores

string (int64 format)

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

formattedNumScores

string

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

ScoreTimeSpan

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

Enums
ALL_TIME O resultado é o placar geral.
WEEKLY A pontuação é semanal.
DAILY A pontuação é diária.

Métodos

get

Receba pontuações mais altas e, opcionalmente, classificações nos placares do jogador autenticado no momento.

list

Lista as pontuações em um placar, começando da parte superior.

listWindow

Lista as pontuações em um placar ao redor (e inclusive) da pontuação de um jogador.

submit

Envia uma pontuação para o placar especificado.

submitMultiple

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