方法：achievementDefinitions.list

列出您应用的所有成就定义。

HTTP 请求

GET https://games.googleapis.com/games/v1/achievements

查询参数

参数
language

字符串

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

整数

要在响应中返回的成就资源的最大数量，用于分页。对于任何响应，返回的实际成就资源数量都可能小于指定的maxResults。
pageToken

字符串

先前请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

成就定义对象的列表。

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

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

字符串

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

字符串

对应于下一页结果的令牌。
items[]

对象（AchievementDefinition）

成就定义。

授权范围

需要以下 OAuth 范围之一

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

有关更多信息，请参阅OAuth 2.0 概述。

AchievementDefinition

成就定义对象。

JSON 表示 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
字段
kind

字符串

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

字符串

成就的 ID。
name

字符串

成就的名称。
description

字符串

成就的描述。
achievementType

枚举（AchievementType）

成就的类型。
totalSteps

整数

递增成就的总步数。
formattedTotalSteps

字符串

递增成就的总步数（字符串格式）。
revealedIconUrl

字符串

已显示成就图标的图片网址。
isRevealedIconUrlDefault

布尔值

指示返回的已显示图标图片是默认图片，还是游戏提供的图片。
unlockedIconUrl

字符串

已解锁成就图标的图片网址。
isUnlockedIconUrlDefault

布尔值

指示返回的已解锁图标图片是默认图片，还是游戏提供的图片。
initialState

枚举（InitialAchievementState）

成就的初始状态。
experiencePoints

字符串（int64 格式）

解锁此成就时将获得的经验值。

AchievementType

可能的成就类型。

枚举
STANDARD 成就是已锁定或已解锁状态。
INCREMENTAL 成就是递增型成就。

InitialAchievementState

成就的可能初始状态。

枚举
HIDDEN 成就已隐藏。
REVEALED 成就已显示。
UNLOCKED 成就已解锁。