- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Stato
- PlayerAchievement
- Stato
- Prova!
Elenca l'avanzamento di tutti gli obiettivi dell'applicazione per il player attualmente autenticato.
Richiesta HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
Parametri del percorso
Parametri | |
---|---|
playerId |
Un ID giocatore. È possibile utilizzare il valore |
Parametri di ricerca
Parametri | |
---|---|
language |
La lingua preferita da utilizzare per le stringhe restituite da questo metodo. |
maxResults |
Il numero massimo di risorse degli obiettivi da restituire nella risposta, utilizzato per il paging. Per qualsiasi risposta, il numero effettivo di risorse dell'obiettivo restituite potrebbe essere inferiore al valore |
pageToken |
Il token restituito dalla richiesta precedente. |
state |
Comunica al server di restituire solo gli obiettivi con lo stato specificato. Se questo parametro non è specificato, vengono restituiti tutti i risultati. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Un elenco di oggetti relativi agli obiettivi.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
Campi | |
---|---|
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
nextPageToken |
Token corrispondente alla pagina dei risultati successiva. |
items[] |
I risultati. |
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.
Stato
Enum | |
---|---|
ALL |
Elenca tutti gli obiettivi. Questa è l'impostazione predefinita. |
HIDDEN |
Elenca solo gli obiettivi nascosti. |
REVEALED |
Elenca solo gli obiettivi rivelati. |
UNLOCKED |
Elenca solo gli obiettivi sbloccati. |
PlayerAchievement
Un oggetto obiettivo.
Rappresentazione JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
Campi | |
---|---|
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
id |
L'ID dell'obiettivo. |
currentSteps |
I passaggi attuali per un obiettivo incrementale. |
formattedCurrentStepsString |
I passaggi attuali per un obiettivo incrementale come stringa. |
achievementState |
Lo stato dell'obiettivo. |
lastUpdatedTimestamp |
Il timestamp dell'ultima modifica allo stato dell'obiettivo. |
experiencePoints |
Punti esperienza guadagnati per l'obiettivo. Questo campo non è presente per gli obiettivi non ancora sbloccati e il valore 0 per gli obiettivi che sono stati sbloccati dai tester, ma che non sono stati pubblicati. |
Stato
Definisce i possibili stati di un obiettivo.
Enum | |
---|---|
HIDDEN |
L'obiettivo è nascosto. |
REVEALED |
L'obiettivo viene rivelato. |
UNLOCKED |
L'obiettivo è stato sbloccato. |