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