REST Resource: scores

Risorsa: GetLeaderboardScoresResponse

Un elenco dei punteggi delle classifiche dei giocatori.

Rappresentazione JSON
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#playerLeaderboardScoreListResponse.

nextPageToken

string

Il token di impaginazione per la pagina successiva dei risultati.

player

object (Player)

Le risorse dei giocatori per il proprietario di questo punteggio.

items[]

object (LeaderboardScore)

I punteggi della classifica.

LeaderboardScore

Un oggetto punteggio della classifica dei giocatori.

Rappresentazione 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
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#playerLeaderboardScore.

leaderboard_id

string

L'ID della classifica in cui si trova questo punteggio.

scoreValue

string (int64 format)

Il valore numerico del punteggio.

scoreString

string

Il valore formattato di questo punteggio.

publicRank

object (LeaderboardScoreRank)

La posizione pubblica del punteggio in questa classifica. Questo oggetto non sarà presente se l'utente non condivide i suoi punteggi pubblicamente.

socialRank

object (LeaderboardScoreRank)

Il ranking social del punteggio in questa classifica.

friendsRank

object (LeaderboardScoreRank)

La posizione del punteggio nella raccolta degli amici per questa classifica.

timeSpan

enum (ScoreTimeSpan)

L'intervallo di tempo di questo punteggio.

writeTimestamp

string (int64 format)

Il timestamp in cui è stato registrato questo punteggio, in millisecondi a partire dall'epoca in UTC.

scoreTag

string

Informazioni aggiuntive sul punteggio. I valori non devono contenere più di 64 caratteri sicuri per l'URI, come definito dalla sezione 2.3 di RFC 3986.

LeaderboardScoreRank

Una classifica dei punteggi.

Rappresentazione JSON
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#leaderboardScoreRank.

rank

string (int64 format)

Il ranking nella classifica.

formattedRank

string

Il ranking nella classifica come stringa.

numScores

string (int64 format)

Il numero di punteggi nella classifica.

formattedNumScores

string

Il numero di punteggi nella classifica come stringa.

ScoreTimeSpan

Definisce i possibili periodi di tempo per un punteggio.

Enum
ALL_TIME Il punteggio è il punteggio più alto.
WEEKLY Il punteggio è settimanale.
DAILY Il punteggio è un punteggio giornaliero.

Metodi

get

Ottieni i punteggi migliori e, facoltativamente, i ranking nelle classifiche del giocatore attualmente autenticato.

list

Elenca i punteggi in una classifica, a partire dal massimo.

listWindow

Elenca i punteggi in una classifica intorno al punteggio di un giocatore (incluso).

submit

Invia un punteggio alla classifica specificata.

submitMultiple

Invia più punteggi alle classifiche.