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. Der Wert me kann anstelle der ID des authentifizierten Spielers verwendet werden.

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.
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 mit Erfolgsobjekten.

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

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

string

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

string

Token, das der nächsten Ergebnisseite entspricht.
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 Alle Erfolge auflisten Das ist die Standardeinstellung.
HIDDEN Nur ausgeblendete Erfolge auflisten.
REVEALED Nur angezeigte Erfolge auflisten.
UNLOCKED Liste nur freigeschaltete Erfolge auf.

PlayerAchievement

Ein Erfolgsobjekt.

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

string

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

string

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)

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 fehlt für Erfolge, die noch nicht freigeschaltet wurden, und den Wert 0 für Erfolge, die von Testern freigeschaltet, aber nicht veröffentlicht wurden.

Status

Definiert mögliche Status eines Erfolgs.

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