Method: achievements.updateMultiple

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

HTTP 要求

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

要求主體

要求主體包含 UpdateMultipleAchievements 的例項。

回應主體

Achieves.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 已解鎖成就。