- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ScoreTimeSpan
- IncludeRankType
- Prova!
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 |
Un ID giocatore. È possibile utilizzare il valore |
leaderboardId |
L'ID della classifica. Può essere impostato su "ALL" per recuperare i dati di tutte le classifiche per questa applicazione. |
timeSpan |
L'intervallo di tempo per i punteggi e i ranking che richiedi. |
Parametri di ricerca
Parametri | |
---|---|
language |
La lingua preferita da utilizzare per le stringhe restituite da questo metodo. |
includeRankType |
I tipi di ranking da restituire. Se il parametro viene omesso, non verranno restituiti ranking. |
maxResults |
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 |
pageToken |
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. |