Method: achievementDefinitions.list

Elenca tutte le definizioni degli obiettivi per la tua domanda.

Richiesta HTTP

GET https://games.googleapis.com/games/v1/achievements

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.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un elenco di oggetti di definizione dei risultati.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
Campi
kind

string

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

string

Token corrispondente alla pagina successiva dei risultati.
items[]

object (AchievementDefinition)

Definizioni degli 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.

AchievementDefinition

Un oggetto definizione obiettivo.

Rappresentazione JSON 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
Campi
kind

string

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

string

L'ID dell'obiettivo.
name

string

Il nome dell'obiettivo.
description

string

La descrizione dell'obiettivo.
achievementType

enum (AchievementType)

Il tipo di risultato.
totalSteps

integer

I passaggi totali per un obiettivo incrementale.
formattedTotalSteps

string

I passaggi totali per un obiettivo incrementale come stringa.
revealedIconUrl

string

L'URL dell'immagine dell'icona dell'obiettivo visualizzata.
isRevealedIconUrlDefault

boolean

Indica se l'immagine dell'icona mostrata che viene restituita è un'immagine predefinita o è fornita dal gioco.
unlockedIconUrl

string

L'URL dell'immagine dell'icona dell'obiettivo sbloccato.
isUnlockedIconUrlDefault

boolean

Indica se l'immagine dell'icona sbloccata che viene restituita è un'immagine predefinita o se è fornita dal gioco.
initialState

enum (InitialAchievementState)

Lo stato iniziale del risultato.
experiencePoints

string (int64 format)

Punti esperienza che verranno guadagnati quando sblocchi questo obiettivo.

AchievementType

Possibili tipi di obiettivi.

Enum
STANDARD L'obiettivo è bloccato o sbloccato.
INCREMENTAL L'obiettivo è incrementale.

InitialAchievementState

Possibili stati iniziali di un obiettivo.

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