Method: achievements.updateMultiple

Atualiza vários conquistas para o jogador autenticado.

Solicitação HTTP

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

Corpo da solicitação

O corpo da solicitação contém uma instância de UpdateMultipleAchievements.

Corpo da resposta

Mensagem de resposta para achievements.updateMultiple rpc.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

O estado atualizado das conquistas.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

UpdateMultipleAchievements

Uma lista de solicitações de atualização de conquistas.

Representação JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

As solicitações de atualização de conquistas individuais.

UpdateAchievement

Uma solicitação para atualizar uma conquista.

Representação JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#achievementUpdateRequest.
achievementId

string

A conquista em que a atualização está sendo aplicada.
updateType

enum (AchievementUpdateType)

O tipo de atualização que está sendo aplicada.
incrementPayload

object (AchievementIncrement)

O payload se uma atualização do tipo INCREMENT foi solicitada para o achievement.
setStepsAtLeastPayload

object (SetAchievementSteps)

O payload se uma atualização do tipo SET_STEPS_AT_LEAST foi solicitada para o achievement.

AchievementUpdateType

Possíveis tipos de atualização de conquistas.

Enumerações
REVEAL A conquista é revelada.
UNLOCK A conquista foi desbloqueada.
INCREMENT A conquista é incrementada.
SET_STEPS_AT_LEAST O progresso da conquista é definido como pelo menos o valor transmitido.

AchievementIncrement

O payload a ser solicitado para incrementar uma conquista.

Representação JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#GamesAchievementIncrement.
steps

integer

O número de etapas a serem incrementadas.
requestId

string (int64 format)

O requestId associado a um incremento de uma conquista.

SetAchievementSteps

O payload a ser solicitado para incrementar uma conquista.

Representação JSON 
{
  "kind": string,
  "steps": integer
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#GamesAchievementSetStepsAtLeast.
steps

integer

O número mínimo de etapas para definir a conquista.

UpdatedAchievement

Uma conquista atualizada.

Representação JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#achievementUpdateResponse.
achievementId

string

A conquista a que essa atualização foi aplicada.
updateOccurred

boolean

Se as atualizações solicitadas realmente afetaram a conquista.
currentState

enum (UpdatedAchievementState)

O estado atual da conquista.
currentSteps

integer

As etapas atuais registradas para essa conquista, se for incremental.
newlyUnlocked

boolean

Se a conquista foi desbloqueada recentemente, ou seja, se a solicitação de desbloqueio foi a primeira do jogador.

UpdatedAchievementState

Possíveis estados de conquistas atualizadas.

Enumerações
HIDDEN A conquista está oculta.
REVEALED A conquista é revelada.
UNLOCKED A conquista foi desbloqueada.