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 已解锁成就。