Method: achievements.updateMultiple

Consente di aggiornare diversi 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 Goals.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 richieste di aggiornamento dei singoli obiettivi.

UpdateAchievement

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 rivelato.
UNLOCK L'obiettivo è stato sbloccato.
INCREMENT L'obiettivo viene incrementato.
SET_STEPS_AT_LEAST L'avanzamento dell'obiettivo è 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)

L'ID richiesta associato a un incremento 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 da impostare per 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 attuali registrati per questo obiettivo se è incrementale.
newlyUnlocked

boolean

Indica se l'obiettivo è stato appena sbloccato (vale a dire se la richiesta di sblocco per l'obiettivo è stata la prima per il giocatore).

UpdatedAchievementState

Possibili stati degli obiettivi aggiornati.

Enum
HIDDEN L'obiettivo è nascosto.
REVEALED L'obiettivo viene rivelato.
UNLOCKED L'obiettivo è stato sbloccato.