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 RPC "Achievements.updateMultiple"

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

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

string

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

object (UpdatedAchievement)

Aktualisierter 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 von Anfragen zur Aktualisierung von Erfolgen

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

string

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

object (UpdateAchievement)

Die einzelnen Anfragen zur Aktualisierung von Erfolgen

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

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

string

Der Erfolg, auf den dieses Update angewendet wird.
updateType

enum (AchievementUpdateType)

Der Typ des angewendeten Updates.
incrementPayload

object (AchievementIncrement)

Nutzlast, falls für den Erfolg eine Aktualisierung vom Typ INCREMENT angefordert wurde
setStepsAtLeastPayload

object (SetAchievementSteps)

Nutzlast, falls für den Erfolg eine Aktualisierung vom Typ SET_STEPS_AT_LEAST angefordert wurde

AchievementUpdateType

Mögliche Aktualisierungsarten von Erfolgen.

Enums
REVEAL Der Erfolg wird aufgedeckt.
UNLOCK Erfolg ist freigeschaltet.
INCREMENT Erfolg wird erhöht.
SET_STEPS_AT_LEAST Für den Fortschritt muss mindestens der übergebene Wert festgelegt werden.

AchievementIncrement

Nutzlast, die angefordert wird, um einen Erfolg zu erhöhen.

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

string

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

integer

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

string (int64 format)

Die Anfrage-ID, die mit einem Inkrement eines Erfolgs verknüpft ist.

SetAchievementSteps

Nutzlast, die angefordert wird, um einen Erfolg zu erhöhen.

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

string

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

integer

Mindestanzahl von Schritten für den Erfolg

UpdatedAchievement

Ein aktualisierter Erfolg

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

string

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

string

Der Erfolg, auf den diese Aktualisierung 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 aktuell für diesen Erfolg erfassten Schritte, falls er inkrementell ist.
newlyUnlocked

boolean

Gibt an, ob dieser Erfolg neu freigeschaltet wurde, d. h., ob die Entsperranforderung für den Erfolg der erste für den Spieler war.

UpdatedAchievementState

Mögliche aktualisierte Erfolgsstatus

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