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 僅列出已解鎖的成就。

PlayerAchievement

關卡物件。

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)

達成成就並獲得成就積分。這個欄位不會顯示尚未解鎖的成就；如果測試人員已解鎖，但尚未發布的成就，則系統不會顯示這個欄位。

狀態

定義關卡的可能狀態，

列舉
HIDDEN 已隱藏成就。
REVEALED 成果已揭示，
UNLOCKED 已解鎖成就。