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 memuat instance UpdateMultipleAchievements.

Isi respons

Pesan respons untukachieve.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 individu.

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 diterapkan atas 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

Kemungkinan jenis update pencapaian.

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

AchievementIncrement

Payload yang diminta untuk meningkatkan 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 ditambah.
requestId

string (int64 format)

requestId yang terkait dengan penambahan pada pencapaian.

SetAchievementSteps

Payload yang diminta untuk meningkatkan 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 langkah minimum yang akan 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. Nilai selalu berupa string tetap games#achievementUpdateResponse.
achievementId

string

Pencapaian yang menerapkan update ini.
updateOccurred

boolean

Apakah update 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 kunci untuk pencapaian ini adalah yang pertama bagi pemain).

UpdatedAchievementState

Kemungkinan status pencapaian yang diperbarui.

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