Method: achievementDefinitions.list

Listet alle Erfolgsdefinitionen für deine App auf.

HTTP-Anfrage

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

Abfrageparameter

Parameter
language

string

Die bevorzugte Sprache, die für Strings verwendet wird, die von dieser Methode zurückgegeben werden.
maxResults

integer

Die maximale Anzahl von Erfolgsressourcen, die in der Antwort zurückgegeben werden sollen; wird für die Seitenordnung verwendet. Für jede Antwort kann die tatsächliche Anzahl der zurückgegebenen Erfolgsressourcen kleiner als die angegebene maxResults sein.
pageToken

string

Das von der vorherigen Anfrage zurückgegebene Token.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste von Erfolgsdefinitionsobjekten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
Felder
kind

string

Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String games#achievementDefinitionsListResponse.
nextPageToken

string

Token, das der nächsten Ergebnisseite entspricht.
items[]

object (AchievementDefinition)

Die Erfolgsdefinitionen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AchievementDefinition

Ein Objekt zur Erfolgsdefinition.

JSON-Darstellung 
{
  "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
}
Felder
kind

string

Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String games#achievementDefinition.
id

string

ID des Erfolgs
name

string

Der Name des Erfolgs.
description

string

Die Beschreibung des Erfolgs.
achievementType

enum (AchievementType)

Der Typ des Erfolgs.
totalSteps

integer

Die Gesamtzahl der Schritte für einen inkrementellen Erfolg.
formattedTotalSteps

string

Die Gesamtzahl der Schritte für einen inkrementellen Erfolg als String.
revealedIconUrl

string

Bild-URL für das Symbol für den aufgedeckten Erfolg
isRevealedIconUrlDefault

boolean

Gibt an, ob das angezeigte Symbolbild ein Standardbild ist oder vom Spiel bereitgestellt wird.
unlockedIconUrl

string

Bild-URL für das freigeschaltete Erfolgssymbol
isUnlockedIconUrlDefault

boolean

Gibt an, ob das zurückgegebene Symbolbild ohne SIM-Lock ein Standardbild ist oder vom Spiel bereitgestellt wird.
initialState

enum (InitialAchievementState)

Anfangsstatus des Erfolgs
experiencePoints

string (int64 format)

Erfahrungspunkte sammeln, wenn Sie diesen Erfolg freischalten.

AchievementType

Mögliche Erfolgstypen.

Enums
STANDARD Der Erfolg ist entweder gesperrt oder entsperrt.
INCREMENTAL Erfolg ist inkrementell.

InitialAchievementState

Mögliche Anfangszustände eines Erfolgs.

Enums
HIDDEN Erfolg ist ausgeblendet.
REVEALED Der Erfolg wird aufgedeckt.
UNLOCKED Erfolg ist freigeschaltet.