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