方法: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[]

对象 (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

枚举 (AchievementType)

成就的类型。

totalSteps

integer

增量成就的总步数。

formattedTotalSteps

string

增量成就的总步数,以字符串表示。

revealedIconUrl

string

显示成就图标的图片 URL。

isRevealedIconUrlDefault

boolean

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

unlockedIconUrl

string

解锁成就图标的图片 URL。

isUnlockedIconUrlDefault

boolean

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

initialState

枚举 (InitialAchievementState)

成就的初始状态。

experiencePoints

string (int64 格式)

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

AchievementType

可能的成就类型。

枚举
STANDARD 成就处于锁定或解锁状态。
INCREMENTAL 成就是增量的。

InitialAchievementState

成就的可能初始状态。

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