Method: achievements.updateMultiple

Actualiza varios logros del 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

Es el mensaje de respuesta para la RPC achievements.updateMultiple.

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)

El estado actualizado de los logros.

Permisos de autorización

Se requiere 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

Es 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)

Las solicitudes de actualización de logros individuales

UpdateAchievement

Es 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 siempre es 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)

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

object (SetAchievementSteps)

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.

Enums
REVEAL Se revela el logro.
UNLOCK Se desbloqueó el logro.
INCREMENT Se incrementa el logro.
SET_STEPS_AT_LEAST El progreso de los logros se establece en, al menos, el valor pasado.

AchievementIncrement

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

integer

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

string (int64 format)

El requestId asociado con un incremento de un logro.

SetAchievementSteps

Es la carga útil que se solicita 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 siempre es la cadena fija games#GamesAchievementSetStepsAtLeast.
steps

integer

Es la cantidad mínima de pasos que se debe establecer 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 siempre es 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)

Es el estado actual del logro.
currentSteps

integer

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 para el jugador).

UpdatedAchievementState

Posibles estados de logros actualizados.

Enums
HIDDEN Se oculta el logro.
REVEALED Se revela el logro.
UNLOCKED Se desbloqueó el logro.