Method: achievements.updateMultiple

Aggiorna più obiettivi per il giocatore attualmente autenticato.

Richiesta HTTP

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

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di UpdateMultipleAchievements.

Corpo della risposta

Messaggio di risposta per obiettivi.updateMultiple rpc.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Lo stato aggiornato degli obiettivi.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateMultipleAchievements

Un elenco di richieste di aggiornamento degli obiettivi.

Rappresentazione JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Le singole richieste di aggiornamento degli obiettivi.

UpdateAchievement

Una richiesta di aggiornamento di un obiettivo.

Rappresentazione JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#achievementUpdateRequest.
achievementId

string

L'obiettivo a cui viene applicato questo aggiornamento.
updateType

enum (AchievementUpdateType)

Il tipo di aggiornamento applicato.
incrementPayload

object (AchievementIncrement)

Il payload se è stato richiesto un aggiornamento di tipo INCREMENT per l'obiettivo.
setStepsAtLeastPayload

object (SetAchievementSteps)

Il payload se è stato richiesto un aggiornamento di tipo SET_STEPS_AT_LEAST per l'obiettivo.

AchievementUpdateType

Possibili tipi di aggiornamento degli obiettivi.

Enum
REVEAL L'obiettivo viene svelato.
UNLOCK Obiettivo sbloccato.
INCREMENT L'obiettivo è stato incrementato.
SET_STEPS_AT_LEAST L'avanzamento degli obiettivi è impostato almeno sul valore superato.

AchievementIncrement

Il payload da richiedere per incrementare un obiettivo.

Rappresentazione JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#GamesAchievementIncrement.
steps

integer

Il numero di passaggi da incrementare.
requestId

string (int64 format)

Il parametro requestId associato a un incremento relativo a un obiettivo.

SetAchievementSteps

Il payload da richiedere per incrementare un obiettivo.

Rappresentazione JSON 
{
  "kind": string,
  "steps": integer
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#GamesAchievementSetStepsAtLeast.
steps

integer

Il numero minimo di passaggi su cui impostare l'obiettivo.

UpdatedAchievement

Un obiettivo aggiornato.

Rappresentazione JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#achievementUpdateResponse.
achievementId

string

L'obiettivo a cui è stato applicato questo aggiornamento.
updateOccurred

boolean

Se gli aggiornamenti richiesti hanno effettivamente influito sull'obiettivo.
currentState

enum (UpdatedAchievementState)

Lo stato attuale dell'obiettivo.
currentSteps

integer

I passaggi correnti registrati per questo obiettivo se sono incrementali.
newlyUnlocked

boolean

Se l'obiettivo è stato sbloccato di recente (ovvero se la richiesta di sblocco è stata la prima per il giocatore).

UpdatedAchievementState

Eventuali stati aggiornati degli obiettivi.

Enum
HIDDEN L'obiettivo è nascosto.
REVEALED L'obiettivo viene svelato.
UNLOCKED Obiettivo sbloccato.