Method: achievements.list

列出目前驗證玩家的所有應用程式成就進度。

HTTP 要求

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

路徑參數

參數
playerId

string

玩家 ID。您可以用 me 值取代已驗證玩家的 ID。

查詢參數

參數
language

string

此方法傳回字串的偏好語言。
maxResults

integer

回應中傳回的關卡資源數量上限，用於分頁。對任何回應而言，傳回的成就資源實際數量可能少於指定的 maxResults。
pageToken

string

上一個要求傳回的權杖。
state

enum (State)

指示伺服器只傳回具有指定狀態的關卡。如未指定此參數，則會傳回所有關卡。

要求主體

要求主體必須為空白。

回應主體

關卡物件清單。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
欄位
kind

string

用於識別這項資源的類型的唯一識別碼。值一律為固定字串 games#playerAchievementListResponse。
nextPageToken

string

對應至下一頁結果的符記。
items[]

object (PlayerAchievement)

關卡。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

詳情請參閱 OAuth 2.0 總覽。

狀態

列舉
ALL 列出所有成就。此為預設值。
HIDDEN 僅列出隱藏的關卡。
REVEALED 僅列出顯示的成就。
UNLOCKED 僅列出已解鎖的成就。

玩家成就

關卡物件。

JSON 表示法 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
欄位
kind

string

用於識別這項資源的類型的唯一識別碼。值一律為固定字串 games#playerAchievement。
id

string

關卡 ID。
currentSteps

integer

漸進式關卡目前的步驟。
formattedCurrentStepsString

string

以字串表示的漸進式關卡目前的步驟。
achievementState

enum (State)

關卡的狀態。
lastUpdatedTimestamp

string (int64 format)

此關卡狀態上次修改的時間戳記。
experiencePoints

string (int64 format)

成就獲得經驗值。但不含尚未解鎖的成就，以及 0 (測試人員已解鎖但尚未發布的成就)。

狀態

定義關卡的可能狀態。

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