列出当前已验证玩家的应用的所有成就的进度。
HTTP 请求
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
路径参数
参数 | |
---|---|
playerId |
玩家 ID。 |
查询参数
参数 | |
---|---|
language |
此方法返回的字符串的首选语言。 |
maxResults |
响应中返回的成就资源的最大数量,用于分页。对于任何响应,实际返回的成就资源数量可能少于指定的 |
pageToken |
先前请求返回的令牌。 |
state |
指示服务器仅返回具有指定状态的成就。如果未指定此参数,则返回所有成就。 |
请求正文
请求正文必须为空。
响应正文
成就对象的列表。
如果成功,响应正文将包含具有以下结构的数据
JSON 表示 |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
nextPageToken |
对应于下一页面结果的令牌。 |
items[] |
成就。 |
授权范围
需要以下 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 ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
id |
成就的 ID。 |
currentSteps |
增量成就的当前步骤。 |
formattedCurrentStepsString |
增量成就的当前步骤(字符串形式)。 |
achievementState |
成就的状态。 |
lastUpdatedTimestamp |
此成就状态上次修改的时间戳。 |
experiencePoints |
为成就获得的经验点数。对于尚未解锁的成就,此字段不存在;对于测试人员已解锁但尚未发布的成就,此字段为 0。 |
状态
定义成就的可能状态。
枚举 | |
---|---|
HIDDEN |
成就已隐藏。 |
REVEALED |
成就已公开。 |
UNLOCKED |
成就已解锁。 |