方法: achievements.increment

为当前已通过身份验证的玩家增加指定 ID 的成就的步数。

HTTP 请求

POST https://games.googleapis.com/games/v1/achievements/{achievementId}/increment

路径参数

参数
achievementId

string

此方法使用的成就 ID。

查询参数

参数
requestId

string (int64 格式)

调用者为每个请求指定的随机生成的数字 ID。此数字在服务器端用于确保请求在重试时得到正确处理。

stepsToIncrement

integer

必需。要增加的步数。

请求正文

请求正文必须为空。

响应正文

成就增加响应

如果成功,响应正文包含以下结构的数据

JSON 表示形式
{
  "kind": string,
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
字段
kind

string

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

currentSteps

integer

为此增量成就记录的当前步数。

newlyUnlocked

boolean

成就的当前步数是否已达到解锁所需的步数。

授权范围

需要以下 OAuth 范围之一

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

如需了解详情,请参阅 OAuth 2.0 概览