Method: achievementDefinitions.list

Listet alle Erfolgsdefinitionen für Ihre Anwendung auf.

HTTP-Anfrage

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

Abfrageparameter

Parameter
language

string

Die bevorzugte Sprache für Strings, 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. Bei jeder Antwort kann die tatsächliche Anzahl der zurückgegebenen Erfolgsressourcen unter dem angegebenen maxResults liegen.
pageToken

string

Das von der vorherigen Anfrage zurückgegebene Token.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste der Objekte zur Definition von Erfolgen.

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

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

string

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

string

Token für die nächste Ergebnisseite.
items[]

object (AchievementDefinition)

Definitionen der Erfolge

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

Objekt zur Definition eines Erfolgs.

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

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

string

Die ID des Erfolgs.
name

string

Der Name des Erfolgs.
description

string

Die Beschreibung des Erfolgs
achievementType

enum (AchievementType)

Die Art 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

Die Bild-URL für das Symbol für den offengelegten Erfolg
isRevealedIconUrlDefault

boolean

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

string

Die Bild-URL für das freigeschaltete Erfolgssymbol.
isUnlockedIconUrlDefault

boolean

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

enum (InitialAchievementState)

Der Ausgangsstatus des Erfolgs.
experiencePoints

string (int64 format)

Erfahrungspunkte, die du beim Freischalten dieses Erfolgs erhältst.

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 wurde aufgedeckt.
UNLOCKED Erfolg wurde freigeschaltet.