Method: achievements.updateMultiple

為目前驗證玩家更新多個成就。

HTTP 要求

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

要求主體

要求主體包含 UpdateMultipleAchievements 的例項。

回應主體

「Achieve.updateMultiple RPC」回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#achievementUpdateMultipleResponse。
updatedAchievements[]

object (UpdatedAchievement)

成就的更新狀態。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

UpdateMultipleAchievements

成就更新要求的清單。

JSON 表示法 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#achievementUpdateMultipleRequest。
updates[]

object (UpdateAchievement)

個別成就更新要求。

UpdateAchievement

更新成就的要求。

JSON 表示法 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#achievementUpdateRequest。
achievementId

string

要套用這項更新的成就。
updateType

enum (AchievementUpdateType)

要套用的更新類型。
incrementPayload

object (AchievementIncrement)

如果為成就要求 INCREMENT 類型更新時則為酬載。
setStepsAtLeastPayload

object (SetAchievementSteps)

如果成就要求更新 SET_STEPS_AT_LEAST 類型，則為酬載。

AchievementUpdateType

可能的成就更新類型。

列舉
REVEAL 成就顯示。
UNLOCK 成就已解鎖。
INCREMENT 成就可遞增。
SET_STEPS_AT_LEAST 成就進度至少要設為傳遞的值。

AchievementIncrement

用於增加成就的酬載。

JSON 表示法 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#GamesAchievementIncrement。
steps

integer

要增加的步驟數。
requestId

string (int64 format)

與成就遞增相關聯的 requestId。

SetAchievementSteps

用於增加成就的酬載。

JSON 表示法 
{
  "kind": string,
  "steps": integer
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#GamesAchievementSetStepsAtLeast。
steps

integer

成就的最低設定步數。

UpdatedAchievement

已更新成就。

JSON 表示法 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#achievementUpdateResponse。
achievementId

string

套用此更新的成就。
updateOccurred

boolean

要求的更新是否確實影響了成就。
currentState

enum (UpdatedAchievementState)

關卡目前的狀態。
currentSteps

integer

如果是累加的成就，目前記錄到的目前步驟。
newlyUnlocked

boolean

此成就是否為新解鎖的成就 (也就是玩家最先提出成就的解鎖要求)。

UpdatedAchievementState

可能的新成就狀態。

列舉
HIDDEN 已隱藏成就。
REVEALED 成就顯示。
UNLOCKED 成就已解鎖。