Method: achievements.updateMultiple

Memperbarui beberapa pencapaian untuk pemain yang saat ini diautentikasi.

Permintaan HTTP

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

Isi permintaan

Isi permintaan berisi instance UpdateMultipleAchievements.

Isi respons

Pesan respons untuk achievements.updateMultiple rpc.

Jika berhasil, isi respons berisi data dengan struktur berikut:

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

string

Secara unik mengidentifikasi jenis resource ini. Nilainya 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. Nilainya 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. Nilainya selalu berupa string tetap games#achievementUpdateRequest.
achievementId

string

Pencapaian yang menjadi sasaran pembaruan 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

Kemungkinan jenis pembaruan pencapaian.

Enum
REVEAL Pencapaian ditampilkan.
UNLOCK Pencapaian berhasil dibuka.
INCREMENT Pencapaian bertambah.
SET_STEPS_AT_LEAST Progres pencapaian ditetapkan setidaknya ke nilai yang diteruskan.

AchievementIncrement

Payload yang akan diminta untuk menambahkan pencapaian.

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

string

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

integer

Jumlah langkah yang akan ditambah.
requestId

string (int64 format)

requestId yang terkait dengan penambahan pencapaian.

SetAchievementSteps

Payload yang akan diminta untuk menambahkan pencapaian.

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

string

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

integer

Jumlah minimum langkah yang ditetapkan untuk pencapaian.

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. Nilainya selalu berupa string tetap games#achievementUpdateResponse.
achievementId

string

Pencapaian yang menjadi sasaran pembaruan 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 saja dibuka (yaitu, apakah permintaan buka untuk pencapaian tersebut adalah yang pertama bagi pemain).

UpdatedAchievementState

Kemungkinan status pencapaian yang diperbarui.

Enum
HIDDEN Pencapaian disembunyikan.
REVEALED Pencapaian ditampilkan.
UNLOCKED Pencapaian berhasil dibuka.