Method: achievements.updateMultiple

Met à jour plusieurs réussites 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 de UpdateMultipleAchievements.

Corps de la réponse

Message de réponse pour le RPC achevé.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 réussites.

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)

Les demandes individuelles de mise à jour des réussites

UpdateAchievement

Demande de mise à jour d'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 de mises à jour de réussites possibles.

Enums
REVEAL La réussite s'affiche.
UNLOCK Réussite déverrouillée.
INCREMENT Les réussites sont incrémentées.
SET_STEPS_AT_LEAST L'avancement de la réussite est défini sur au moins la valeur transmise.

AchievementIncrement

Charge utile à demander pour incrémenter une réussite.

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'une réussite.

SetAchievementSteps

Charge utile à demander pour incrémenter une réussite.

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 pour que la réussite soit définie.

UpdatedAchievement

Un succès mis à 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

La réussite à laquelle cette mise à jour a été appliquée.

updateOccurred

boolean

Indique si les mises à jour demandées ont réellement eu une incidence sur la réussite.

currentState

enum (UpdatedAchievementState)

État actuel de la réussite.

currentSteps

integer

Les étapes actuelles enregistrées pour cette réussite si elle est progressive.

newlyUnlocked

boolean

Indique si la réussite vient d'être déverrouillée (c'est-à-dire si la demande de déverrouillage de la réussite a été la première pour le joueur).

UpdatedAchievementState

États de réussite mis à jour possibles.

Enums
HIDDEN La réussite est masquée.
REVEALED La réussite s'affiche.
UNLOCKED Réussite déverrouillée.