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