Method: achievements.list

Consente di visualizzare l'avanzamento di tutti gli obiettivi della tua applicazione relativi al 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 giocatore autenticato.

Parametri di query

Parametri
language

string

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

integer

Il numero massimo di risorse per obiettivi da restituire nella risposta, utilizzate per il paging. Per qualsiasi risposta, il numero effettivo di risorse per gli obiettivi restituite potrebbe essere inferiore al valore maxResults specificato.
pageToken

string

Il token restituito dalla richiesta precedente.
state

enum (State)

Indica al server di restituire solo gli obiettivi con lo stato specificato. Se questo parametro non viene specificato, vengono restituiti tutti gli obiettivi.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un elenco di oggetti per i risultati.

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 successiva dei risultati.
items[]

object (PlayerAchievement)

Gli obiettivi.

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 visualizzati.
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 del risultato.
lastUpdatedTimestamp

string (int64 format)

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

string (int64 format)

Punti esperienza guadagnati per l'obiettivo. Questo campo è assente per gli obiettivi che non sono ancora stati sbloccati e 0 per gli obiettivi che sono stati sbloccati dai tester, ma che non sono pubblicati.

Stato

Definisce i possibili stati di un risultato.

Enum
HIDDEN L'obiettivo è nascosto.
REVEALED L'obiettivo viene svelato.
UNLOCKED Obiettivo sbloccato.