方法：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 成就被解锁。