Method: achievements.updateMultiple

Aktualisiert mehrere Erfolge für den derzeit authentifizierten Spieler

HTTP-Anfrage

POST https://games.googleapis.com/games/v1/achievements/updateMultiple

Anfragetext

Der Anfragetext enthält eine Instanz von UpdateMultipleAchievements.

Antworttext

Antwortnachricht für Erfolge.updateMultiple-RPC

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

JSON-Darstellung 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Der aktualisierte Status 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.

UpdateMultipleAchievements

Eine Liste der Anfragen zur Aktualisierung von Erfolgen.

JSON-Darstellung 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Die einzelnen Anfragen zur Aktualisierung des Erfolgs

UpdateAchievement

Eine Anfrage zum Aktualisieren eines Erfolgs.

JSON-Darstellung 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Felder
kind

string

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

string

Der Erfolg, auf den dieses Update angewendet wird.
updateType

enum (AchievementUpdateType)

Die Art der Aktualisierung, die angewendet wird.
incrementPayload

object (AchievementIncrement)

Die Nutzlast, wenn eine Aktualisierung des Typs INCREMENT für den Erfolg angefordert wurde.
setStepsAtLeastPayload

object (SetAchievementSteps)

Die Nutzlast, wenn eine Aktualisierung des Typs SET_STEPS_AT_LEAST für den Erfolg angefordert wurde.

AchievementUpdateType

Mögliche Aktualisierungstypen für Erfolge

Enums
REVEAL Der Erfolg wurde aufgedeckt.
UNLOCK Erfolg wurde freigeschaltet.
INCREMENT Der Wert für den Erfolg wird erhöht.
SET_STEPS_AT_LEAST Der Fortschritt des Erfolgs ist mindestens auf den übergebenen Wert festgelegt.

AchievementIncrement

Die Nutzlast, die zum Erhöhen eines Erfolgs angefordert werden soll.

JSON-Darstellung 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Felder
kind

string

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

integer

Die Anzahl der Schritte, die erhöht werden sollen.
requestId

string (int64 format)

Die requestId, die einem Inkrement eines Erfolgs zugeordnet ist.

SetAchievementSteps

Die Nutzlast, die zum Erhöhen eines Erfolgs angefordert werden soll.

JSON-Darstellung 
{
  "kind": string,
  "steps": integer
}
Felder
kind

string

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

integer

Die Mindestanzahl von Schritten, die für den Erfolg festgelegt werden soll.

UpdatedAchievement

Ein aktualisierter Erfolg

JSON-Darstellung 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Felder
kind

string

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

string

Der Erfolg, auf den dieses Update angewendet wurde.
updateOccurred

boolean

Gibt an, ob sich die angeforderten Updates tatsächlich auf den Erfolg ausgewirkt haben.
currentState

enum (UpdatedAchievementState)

Der aktuelle Status des Erfolgs.
currentSteps

integer

Die aktuellen Schritte, die für diesen Erfolg erfasst wurden, falls er inkrementell ist
newlyUnlocked

boolean

Ob dieser Erfolg neu freigeschaltet wurde, d. h., ob die Entsperrungsanforderung für den Erfolg die erste Anfrage des Spielers war.

UpdatedAchievementState

Mögliche aktualisierte Erfolgszustände

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