列出当前已通过身份验证的玩家的所有应用成就进度。
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 |
已解锁成就。 |