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