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