Method: achievements.list

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

string

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

Parametri di ricerca

Parametri
language

string

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

integer

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 maxResults specificato.
pageToken

string

Il token restituito dalla richiesta precedente.
state

enum (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 (PlayerAchievement)
    }
  ]
}
Campi
kind

string

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

string

Token corrispondente alla pagina dei risultati successiva.
items[]

object (PlayerAchievement)

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 (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Campi
kind

string

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

string

L'ID dell'obiettivo.
currentSteps

integer

I passaggi attuali per un obiettivo incrementale.
formattedCurrentStepsString

string

I passaggi attuali per un obiettivo incrementale come stringa.
achievementState

enum (State)

Lo stato dell'obiettivo.
lastUpdatedTimestamp

string (int64 format)

Il timestamp dell'ultima modifica allo stato dell'obiettivo.
experiencePoints

string (int64 format)

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.