Method: achievements.list

Listet den Fortschritt aller Erfolge Ihrer Anwendung für den derzeit authentifizierten Spieler auf.

HTTP-Anfrage

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

Pfadparameter

Parameter
playerId

string

Eine Spieler-ID. Anstelle der ID des authentifizierten Spielers kann der Wert me verwendet werden.

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.
state

enum (State)

Weist den Server an, nur Erfolge mit dem angegebenen Status zurückzugeben. Wenn dieser Parameter nicht angegeben ist, werden alle Erfolge zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste der Erfolgsobjekte.

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

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

string

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

string

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

object (PlayerAchievement)

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

Status

Enums
ALL Liste alle Erfolge auf. Das ist die Standardeinstellung.
HIDDEN Listet nur ausgeblendete Erfolge auf.
REVEALED Nur angezeigte Erfolge auflisten.
UNLOCKED Nur entsperrte Erfolge auflisten.

PlayerAchievement

Ein Erfolgsobjekt

JSON-Darstellung 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Felder
kind

string

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

string

Die ID des Erfolgs.
currentSteps

integer

Die aktuellen Schritte für einen inkrementellen Erfolg.
formattedCurrentStepsString

string

Die aktuellen Schritte für einen inkrementellen Erfolg als String.
achievementState

enum (State)

Der Status des Erfolgs.
lastUpdatedTimestamp

string (int64 format)

Zeitstempel der letzten Änderung des Status dieses Erfolgs
experiencePoints

string (int64 format)

Erfahrungspunkte für den Erfolg Dieses Feld gibt es nicht für Erfolge, die noch nicht freigeschaltet wurden, und 0 für Erfolge, die von Testern freigeschaltet, aber nicht veröffentlicht wurden.

Status

Definiert mögliche Statuswerte für einen Erfolg.

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