Method: scores.get

Ottieni i migliori punteggi e, facoltativamente, i ranking nelle classifiche del giocatore attualmente autenticato. Per un intervallo di tempo specifico, è possibile impostare leaderboardId su ALL per recuperare i dati di tutte le classifiche in un determinato intervallo di tempo. "NOTA: non puoi chiedere "TUTTE" le classifiche e "TUTTI" gli timeSpan nella stessa richiesta; un solo parametro può essere impostato su "ALL".

Richiesta HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

Parametri del percorso

Parametri
playerId

string

Un ID giocatore. È possibile utilizzare il valore me al posto dell'ID del player autenticato.
leaderboardId

string

L'ID della classifica. Può essere impostato su "ALL" per recuperare i dati di tutte le classifiche per questa applicazione.
timeSpan

enum (ScoreTimeSpan)

L'intervallo di tempo per i punteggi e i ranking che richiedi.

Parametri di ricerca

Parametri
language

string

La lingua preferita da utilizzare per le stringhe restituite da questo metodo.
includeRankType

enum (IncludeRankType)

I tipi di ranking da restituire. Se il parametro viene omesso, non verranno restituiti ranking.
maxResults

integer

Il numero massimo di punteggi della classifica da restituire nella risposta. Per qualsiasi risposta, il numero effettivo di punteggi della classifica restituiti potrebbe essere inferiore al valore maxResults specificato.
pageToken

string

Il token restituito dalla richiesta precedente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di GetLeaderboardScoresResponse.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ScoreTimeSpan

Definisce i possibili intervalli di tempo per un punteggio.

Enum
ALL Ottieni i migliori punteggi per tutti gli intervalli di tempo. Se utilizzato, i valori maxResults verranno ignorati.
ALL_TIME Ottieni il miglior punteggio assoluto.
WEEKLY Elenca i punteggi migliori per il giorno corrente.
DAILY Elenca i punteggi migliori per la settimana in corso.

IncludeRankType

Valori possibili per il tipo di ranking.

Enum
ALL Recupera tutti i ranking supportati. In HTTP, questo valore parametro può essere specificato anche come ALL.
PUBLIC Recuperare i livelli pubblici se il giocatore condivide la sua attività di gioco pubblicamente.
SOCIAL

(Obsoleto) Recupera il ranking social.
FRIENDS Recupera il tuo ranking nella raccolta di amici.