Method: achievements.updateMultiple

Atualiza várias conquistas para o jogador autenticado no momento.

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 conquistas.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 de 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 conquista.

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 da conquista individual.

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 a 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 a conquista.
setStepsAtLeastPayload

object (SetAchievementSteps)

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

AchievementUpdateType

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

Enums
REVEAL A conquista é revelada.
UNLOCK A conquista está desbloqueada.
INCREMENT A conquista foi incrementada.
SET_STEPS_AT_LEAST O progresso da conquista está 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 para 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 a conquista ser definida.

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 a atualização foi aplicada.
updateOccurred

boolean

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

enum (UpdatedAchievementState)

O estado atual da conquista.
currentSteps

integer

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

boolean

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

UpdatedAchievementState

Possíveis estados de conquista atualizados.

Enums
HIDDEN A conquista está oculta.
REVEALED A conquista é revelada.
UNLOCKED A conquista está desbloqueada.