方法:achievements.list

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

HTTP 请求

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

路径参数

参数
playerId

字符串

玩家 ID。me 值可用于代替已验证玩家的 ID。

查询参数

参数
language

字符串

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

maxResults

整数

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

pageToken

字符串

先前请求返回的令牌。

state

枚举 (State)

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

请求正文

请求正文必须为空。

响应正文

成就对象的列表。

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

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

字符串

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

nextPageToken

字符串

对应于下一页面结果的令牌。

items[]

对象 (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

字符串

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

id

字符串

成就的 ID。

currentSteps

整数

增量成就的当前步骤。

formattedCurrentStepsString

字符串

增量成就的当前步骤(字符串形式)。

achievementState

枚举 (State)

成就的状态。

lastUpdatedTimestamp

字符串 (int64 格式)

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

experiencePoints

字符串 (int64 格式)

为成就获得的经验点数。对于尚未解锁的成就,此字段不存在;对于测试人员已解锁但尚未发布的成就,此字段为 0。

状态

定义成就的可能状态。

枚举
HIDDEN 成就已隐藏。
REVEALED 成就已公开。
UNLOCKED 成就已解锁。