Method: achievementDefinitions.list

Elenca tutte le definizioni degli obiettivi per la tua applicazione.

Richiesta HTTP

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

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.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un elenco di oggetti di definizione degli obiettivi.

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

object (AchievementDefinition)

Le 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 di definizione di un 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 obiettivo.
totalSteps

integer

I passaggi totali per un obiettivo incrementale.
formattedTotalSteps

string

I passaggi totali per un obiettivo incrementale come stringa.
revealedIconUrl

string

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

boolean

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

string

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

boolean

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

enum (InitialAchievementState)

Lo stato iniziale dell'obiettivo.
experiencePoints

string (int64 format)

Punti esperienza che guadagnerai sbloccando 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 rivelato.
UNLOCKED L'obiettivo è stato sbloccato.