Method: achievementDefinitions.list

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

HTTP 请求

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

查询参数

参数
language

string

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

integer

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

string

上一个请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

成就定义对象的列表。

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

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

string

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

string

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

object (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

string

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

string

成就的 ID。
name

string

成就的名称。
description

string

成就的说明。
achievementType

enum (AchievementType)

成就的类型。
totalSteps

integer

分步成就所需的总步骤。
formattedTotalSteps

string

增量成就的总步数（以字符串表示）。
revealedIconUrl

string

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

boolean

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

string

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

boolean

指明返回的未锁定图标图片是默认图片还是由游戏提供的图片。
initialState

enum (InitialAchievementState)

成就的初始状态。
experiencePoints

string (int64 format)

解锁这项成就即可赚取经验值。

AchievementType

可能的成就类型。

枚举
STANDARD 成就已锁定或已解锁。
INCREMENTAL 成就是渐进式的。

InitialAchievementState

成就可能的初始状态。

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