方法: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[]

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

对象 (UpdateAchievement)

单个成就更新请求。

UpdateAchievement

更新成就的请求。

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

string

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

achievementId

string

此更新所应用于的成就。

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

string

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

steps

integer

要递增的步数。

requestId

string(int64 格式)

与成就递增相关的 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

枚举 (UpdatedAchievementState)

成就的当前状态。

currentSteps

integer

如果此成就是递增的,则为记录的当前步数。

newlyUnlocked

boolean

此成就是否刚刚解锁(即对成就的解锁请求是否是玩家的第一次请求)。

UpdatedAchievementState

可能的更新成就状态。

枚举
HIDDEN 成就已隐藏。
REVEALED 成就已揭示。
UNLOCKED 成就已解锁。