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 incluye una instancia de UpdateMultipleAchievements.

Cuerpo de la respuesta

Mensaje de respuesta para backends.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 exclusiva el tipo de este recurso. El valor es siempre la string fija games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Es el estado actualizado de los logros.

Permisos de la 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.

UpdateMultipleLogs

Lista de solicitudes de actualización de logros.

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

string

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

object (UpdateAchievement)

Las solicitudes individuales de actualización de logros

ActualizarLogro

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 exclusiva el tipo de este recurso. El valor es siempre la string 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)

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.

Tipo de actualización de logro

Tipos posibles de actualizaciones de logros.

Enumeradores
REVEAL Se revela el logro.
UNLOCK El logro está desbloqueado.
INCREMENT El logro se incrementa.
SET_STEPS_AT_LEAST El progreso del logro se estableció al menos en el valor aprobado.

Incremento de logros

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

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

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#GamesAchievementIncrement.
steps

integer

La cantidad de pasos que se incrementarán.
requestId

string (int64 format)

El requestId asociado con un incremento a un logro.

Pasos para establecer un logro

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

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

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#GamesAchievementSetStepsAtLeast.
steps

integer

Es la cantidad mínima de pasos en los que se debe establecer el logro.

Logro actualizado

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 exclusiva el tipo de este recurso. El valor es siempre la string 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

Son 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 para el logro fue la primera del jugador).

Estado del logro actualizado

Se actualizaron los estados de logros posibles.

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