Method: achievements.updateMultiple

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

HTTP 请求

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

请求正文

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

响应正文

针对 achievements.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 已解锁成就。