Method: achievements.updateMultiple

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

HTTP 请求

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

请求正文

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

响应正文

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