Method: achievements.updateMultiple

为当前已通过身份验证的玩家更新多项成就。

HTTP 请求

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

请求正文

请求正文包含一个 UpdateMultipleAchievements 实例。

响应正文

ROAS.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 已解锁成就。