方法：achievements.updateMultiple

更新当前已验证玩家的多个成就。

HTTP 请求

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

请求正文

请求正文包含 UpdateMultipleAchievements 的实例。

响应正文

achievements.updateMultiple rpc 的响应消息。

如果成功，响应正文将包含具有以下结构的数据

JSON 表示 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#achievementUpdateMultipleResponse。
updatedAchievements[]

对象 (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

字符串

唯一标识此资源的类型。值始终是固定字符串 games#achievementUpdateMultipleRequest。
updates[]

对象 (UpdateAchievement)

各个成就更新请求。

UpdateAchievement

更新成就的请求。

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

字符串

唯一标识此资源的类型。值始终是固定字符串 games#achievementUpdateRequest。
achievementId

字符串

此更新应用到的成就。
updateType

枚举 (AchievementUpdateType)

应用的更新类型。
incrementPayload

对象 (AchievementIncrement)

如果请求对成就进行 INCREMENT 类型的更新，则为有效负载。
setStepsAtLeastPayload

对象 (SetAchievementSteps)

如果请求对成就进行 SET_STEPS_AT_LEAST 类型的更新，则为有效负载。

AchievementUpdateType

可能的成就更新类型。

枚举
REVEAL 成就已显示。
UNLOCK 成就已解锁。
INCREMENT 成就已递增。
SET_STEPS_AT_LEAST 成就进度设置为至少传递的值。

AchievementIncrement

请求递增成就的有效负载。

JSON 表示 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#GamesAchievementIncrement。
steps

整数

要递增的步数。
requestId

字符串 (int64 格式)

与成就递增相关的 requestId。

SetAchievementSteps

请求递增成就的有效负载。

JSON 表示 
{
  "kind": string,
  "steps": integer
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#GamesAchievementSetStepsAtLeast。
steps

整数

成就要设置为的最小步数。

UpdatedAchievement

已更新的成就。

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

字符串

唯一标识此资源的类型。值始终是固定字符串 games#achievementUpdateResponse。
achievementId

字符串

此更新应用到的成就。
updateOccurred

布尔值

请求的更新是否实际影响了成就。
currentState

枚举 (UpdatedAchievementState)

成就的当前状态。
currentSteps

整数

如果成就可递增，则为此成就记录的当前步数。
newlyUnlocked

布尔值

此成就是否为新解锁（即，此成就的解锁请求是否是玩家的第一次请求）。

UpdatedAchievementState

可能的更新后的成就状态。

枚举
隐藏 成就已隐藏。
显示 成就已显示。
已解锁 成就已解锁。