Method: achievements.list

列出当前已通过身份验证的玩家的所有应用成就进度。

HTTP 请求

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

路径参数

参数
playerId

string

玩家 ID。可以使用值me来代替通过身份验证的玩家的 ID。

查询参数

参数
language

string

此方法返回的字符串的首选语言。
maxResults

integer

响应中可返回的最大成就资源数，用于分页。对于任何响应，返回的实际成就资源数量可能少于指定的 maxResults。
pageToken

string

上一个请求返回的令牌。
state

enum (State)

指示服务器仅返回具有指定状态的成就。如果未指定此参数，则返回所有成就。

请求正文

请求正文必须为空。

响应正文

成就对象的列表。

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

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
字段
kind

string

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

string

与下一页结果对应的令牌。
items[]

object (PlayerAchievement)

成就。

授权范围

需要以下 OAuth 范围之一：

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

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

州

枚举
ALL 列出所有成就。这是默认值。
HIDDEN 仅列出隐藏的成就。
REVEALED 仅列出已显示的成就。
UNLOCKED 仅列出已达成的成就。

PlayerAchievement

成就对象。

JSON 表示法 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
字段
kind

string

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

string

成就的 ID。
currentSteps

integer

当前分步成就的步骤。
formattedCurrentStepsString

string

以字符串表示的分步成就的当前步骤。
achievementState

enum (State)

成就的状态。
lastUpdatedTimestamp

string (int64 format)

上次修改该成就状态的时间戳。
experiencePoints

string (int64 format)

通过成就赚取的经验值。对于尚未解锁的成就，此字段不会显示；对于测试人员已解锁但尚未发布的成就，此字段为 0。

州

定义成就的可能状态。

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