Method: achievements.updateMultiple

Met à jour plusieurs succès pour le joueur actuellement authentifié.

Requête HTTP

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

Corps de la requête

Le corps de la requête contient une instance UpdateMultipleAchievements.

Corps de la réponse

Message de réponse pour le rpc results.updateMultiple.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#achievementUpdateMultipleResponse.

updatedAchievements[]

object (UpdatedAchievement)

État mis à jour des succès.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

UpdateMultipleAchievements

Liste des demandes de mise à jour des réussites.

Représentation JSON
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#achievementUpdateMultipleRequest.

updates[]

object (UpdateAchievement)

Demandes de mise à jour des réussites individuelles

UpdateAchievement

Requête permettant de mettre à jour un succès.

Représentation JSON
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#achievementUpdateRequest.

achievementId

string

Succès auquel cette mise à jour est appliquée.

updateType

enum (AchievementUpdateType)

Type de mise à jour appliquée.

incrementPayload

object (AchievementIncrement)

Charge utile si une mise à jour de type INCREMENT a été demandée pour la réussite.

setStepsAtLeastPayload

object (SetAchievementSteps)

Charge utile si une mise à jour de type SET_STEPS_AT_LEAST a été demandée pour la réussite.

AchievementUpdateType

Types possibles de mise à jour des réussites.

Enums
REVEAL La réussite est révélée.
UNLOCK Réussite déverrouillée.
INCREMENT La réussite est incrémentée.
SET_STEPS_AT_LEAST La progression de l'obtention de la réussite est définie sur au moins la valeur transmise.

AchievementIncrement

Charge utile à demander pour augmenter un succès.

Représentation JSON
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#GamesAchievementIncrement.

steps

integer

Nombre d'étapes à incrémenter.

requestId

string (int64 format)

Le requestId associé à un incrément d'un succès.

SetAchievementSteps

Charge utile à demander pour augmenter un succès.

Représentation JSON
{
  "kind": string,
  "steps": integer
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#GamesAchievementSetStepsAtLeast.

steps

integer

Nombre minimal d'étapes à définir pour la réussite.

UpdatedAchievement

Réussite mise à jour.

Représentation JSON
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#achievementUpdateResponse.

achievementId

string

Succès auquel cette mise à jour a été appliquée.

updateOccurred

boolean

Indique si les mises à jour demandées ont réellement affecté la réussite.

currentState

enum (UpdatedAchievementState)

État actuel du succès.

currentSteps

integer

Les étapes actuelles enregistrées pour cette réussite s'il est incrémentiel.

newlyUnlocked

boolean

Indique si la réussite a été récemment déverrouillée (c'est-à-dire si la demande de déverrouillage de la réussite était la première envoyée par le joueur).

UpdatedAchievementState

États de réussite mis à jour possibles.

Enums
HIDDEN La réussite est masquée.
REVEALED La réussite est révélée.
UNLOCKED Réussite déverrouillée.