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)

解鎖這項成就即可獲得經驗值，

成就類型

可能的成就類型。

列舉
STANDARD 成就處於鎖定或解鎖狀態。
INCREMENTAL 而成就會不斷增加。

InitialAchievementState

關卡的初始狀態。

列舉
HIDDEN 已隱藏成就。
REVEALED 顯示成就。
UNLOCKED 成就已解鎖。