Method: achievements.updateMultiple

Memperbarui beberapa pencapaian untuk pemain yang saat ini sudah diautentikasi.

Permintaan HTTP

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

Isi permintaan

Isi permintaan memuat instance UpdateMultipleAchievements.

Isi respons

Pesan respons untuk pencapaian.updateMultiple rpc.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

Status pencapaian yang diperbarui.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UpdateMultipleAchievements

Daftar permintaan pembaruan pencapaian.

Representasi JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Permintaan pembaruan pencapaian individual.

UpdateAchievement

Permintaan untuk memperbarui pencapaian.

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

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#achievementUpdateRequest.
achievementId

string

Pencapaian yang menerapkan update ini.
updateType

enum (AchievementUpdateType)

Jenis update yang diterapkan.
incrementPayload

object (AchievementIncrement)

Payload jika update jenis INCREMENT diminta untuk pencapaian.
setStepsAtLeastPayload

object (SetAchievementSteps)

Payload jika update jenis SET_STEPS_AT_LEAST diminta untuk pencapaian.

AchievementUpdateType

Jenis pembaruan pencapaian yang mungkin.

Enum
REVEAL Pencapaian terungkap.
UNLOCK Pencapaian terbuka.
INCREMENT Pencapaian bertambah.
SET_STEPS_AT_LEAST Progres pencapaian ditetapkan ke setidaknya nilai yang diteruskan.

AchievementIncrement

Payload yang diminta untuk menambahkan pencapaian.

Representasi JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#GamesAchievementIncrement.
steps

integer

Jumlah langkah yang akan bertambah.
requestId

string (int64 format)

requestId yang terkait dengan penambahan pencapaian.

SetAchievementSteps

Payload yang diminta untuk menambahkan pencapaian.

Representasi JSON 
{
  "kind": string,
  "steps": integer
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#GamesAchievementSetStepsAtLeast.
steps

integer

Jumlah minimum langkah untuk pencapaian yang akan ditetapkan.

UpdatedAchievement

Pencapaian yang diperbarui.

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

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#achievementUpdateResponse.
achievementId

string

Pencapaian yang menerapkan update ini.
updateOccurred

boolean

Apakah pembaruan yang diminta benar-benar memengaruhi pencapaian.
currentState

enum (UpdatedAchievementState)

Status pencapaian saat ini.
currentSteps

integer

Langkah saat ini yang dicatat untuk pencapaian ini jika bersifat inkremental.
newlyUnlocked

boolean

Apakah pencapaian ini baru dibuka (yaitu, apakah permintaan buka kunci untuk pencapaian tersebut adalah yang pertama bagi pemain).

UpdatedAchievementState

Kemungkinan status pencapaian yang diperbarui.

Enum
HIDDEN Pencapaian disembunyikan.
REVEALED Pencapaian terungkap.
UNLOCKED Pencapaian terbuka.