Method: achievements.updateMultiple

Actualiza varios logros del jugador actualmente autenticado.

Solicitud HTTP

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

Cuerpo de la solicitud

El cuerpo de la solicitud incluye 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 siempre es la cadena fija games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Es el estado actualizado de los logros.

Permisos de autorización

Se necesita uno de los siguientes alcances 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 siempre es la cadena fija games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Solicitudes individuales de actualización de logros

UpdateAchievement

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 siempre es la cadena fija games#achievementUpdateRequest.
achievementId

string

Logro al que se aplica esta actualización.
updateType

enum (AchievementUpdateType)

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

object (AchievementIncrement)

Es la carga útil si se solicitó una actualización de tipo INCREMENT para el logro.
setStepsAtLeastPayload

object (SetAchievementSteps)

Es la carga útil si se solicitó una actualización de tipo SET_STEPS_AT_LEAST para el logro.

AchievementUpdateType

Posibles tipos de actualización de logros.

Enumeradores
REVEAL Se revela el logro.
UNLOCK El logro está desbloqueado.
INCREMENT El logro aumenta.
SET_STEPS_AT_LEAST El progreso del logro se establece en, al menos, el valor aprobado.

AchievementIncrement

Es la carga útil que se debe solicitar para aumentar 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 siempre es la cadena fija games#GamesAchievementIncrement.
steps

integer

Es la cantidad de pasos que se incrementarán.
requestId

string (int64 format)

Es el requestId asociado con un incremento en un logro.

SetAchievementSteps

Es la carga útil que se debe solicitar para aumentar un logro.

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

string

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

integer

Es la cantidad mínima de pasos que se debe establecer en 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 siempre es la cadena fija games#achievementUpdateResponse.
achievementId

string

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

boolean

Indica si las actualizaciones solicitadas realmente afectaron el logro.
currentState

enum (UpdatedAchievementState)

Es el estado actual del logro.
currentSteps

integer

Los pasos actuales que se registran 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 del jugador).

UpdatedAchievementState

Posibles estados de logros actualizados

Enumeradores
HIDDEN El logro está oculto.
REVEALED Se revela el logro.
UNLOCKED El logro está desbloqueado.