Method: achievements.updateMultiple

Actualiza varios logros para el jugador autenticado actualmente.

Solicitud HTTP

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de UpdateMultipleAchievements.

Cuerpo de la respuesta

Mensaje de respuesta para logros.updateMultiple rpc.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

El estado actualizado de los logros.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

UpdateMultipleAchievements

Una lista de solicitudes de actualización de logros.

Representación JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Las solicitudes de actualización de logros individuales.

UpdateAchievement

Una solicitud para actualizar un logro

Representación JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#achievementUpdateRequest.
achievementId

string

El logro al que se aplica esta actualización.
updateType

enum (AchievementUpdateType)

Es el tipo de actualización que se aplica.
incrementPayload

object (AchievementIncrement)

Indica la carga útil en caso de que se haya solicitado una actualización del tipo INCREMENT para el logro.
setStepsAtLeastPayload

object (SetAchievementSteps)

Indica la carga útil en caso de que se haya solicitado una actualización del tipo SET_STEPS_AT_LEAST para el logro.

AchievementUpdateType

Tipos de actualización de logros posibles.

Enumeraciones
REVEAL El logro se revela.
UNLOCK El logro está desbloqueado.
INCREMENT El logro aumenta.
SET_STEPS_AT_LEAST El progreso del logro se estableció en, al menos, el valor que se pasó.

AchievementIncrement

La carga útil que se debe solicitar para incrementar un logro.

Representación JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#GamesAchievementIncrement.
steps

integer

La cantidad de pasos que se aumentará.
requestId

string (int64 format)

El requestId asociado con un incremento a un logro.

SetAchievementSteps

La carga útil que se debe solicitar para incrementar un logro.

Representación JSON 
{
  "kind": string,
  "steps": integer
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#GamesAchievementSetStepsAtLeast.
steps

integer

Es la cantidad mínima de pasos que debe establecerse para el logro.

UpdatedAchievement

Un logro actualizado.

Representación JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#achievementUpdateResponse.
achievementId

string

El logro al que se aplicó esta actualización.
updateOccurred

boolean

Si las actualizaciones solicitadas realmente afectaron el logro
currentState

enum (UpdatedAchievementState)

El estado actual del logro.
currentSteps

integer

Indica los pasos actuales registrados para este logro, si es incremental.
newlyUnlocked

boolean

Indica si este logro se desbloqueó recientemente (es decir, si la solicitud de desbloqueo del logro fue la primera que recibió el jugador).

UpdatedAchievementState

Posibles estados actualizados del logro.

Enumeraciones
HIDDEN El logro está oculto.
REVEALED El logro se revela.
UNLOCKED El logro está desbloqueado.