Achievements: list

注意：需要授權。

列出目前已驗證玩家在應用程式中的所有成就的進度。 立即試用。

要求

HTTP 要求

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

參數

參數名稱	值	說明
路徑參數
playerId	string	玩家 ID。你可以使用 me 的值來取代已驗證的玩家 ID。
選用查詢參數
language	string	此方法傳回的字串偏好語言。
maxResults	integer	回應中可傳回的成就資源數量上限，用於分頁。無論是哪種回應，傳回的實際成就資源數量可能少於指定的 maxResults。可接受的值為 1 到 200 (含首尾)。
pageToken	string	先前要求傳回的符記。
state	string	讓伺服器只傳回指定狀態的成就。如未指定此參數，則會傳回所有成就。 可接受的值如下： 「ALL」：列出所有成就。(此為預設值)。 "HIDDEN"：只列出隱藏的成就。 "REVEALED"：只列出揭露的成就。 "UNLOCKED"：只列出已解鎖的成就。

授權

此要求需要以下範圍的授權：

範圍
https://www.googleapis.com/auth/games

詳情請參閱驗證和授權頁面。

要求主體

請不要透過此方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "games#playerAchievementListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#playerAchievement",
      "id": string,
      "currentSteps": integer,
      "formattedCurrentStepsString": string,
      "achievementState": string,
      "lastUpdatedTimestamp": long,
      "experiencePoints": long
    }
  ]
}

屬性名稱	值	說明	Notes
kind	string	用於識別這項資源的類型。值一律為固定字串 games#playerAchievementListResponse。
nextPageToken	string	下一頁的結果對應符記。
items[]	list	成就
items[].kind	string	用於識別這項資源的類型。值一律為固定字串 games#playerAchievement。
items[].id	string	成就 ID。
items[].currentSteps	integer	目前漸進式成就的步驟。
items[].formattedCurrentStepsString	string	以遞增方式呈現的成就目前步驟。
items[].achievementState	string	成就的狀態。 可能的值包括： 「HIDDEN」：已隱藏成就。 「REVEALED」：已顯示成就。 「UNLOCKED」：已解鎖成就。 可接受的值如下： 「HIDDEN」 「REVEALED」 「UNLOCKED」
items[].lastUpdatedTimestamp	long	此成就上次修改時的時間戳記。
items[].experiencePoints	long	獲得成就的積分。對於尚未解鎖的成就，這個欄位不會顯示；0 是已取得測試人員解鎖但未發布的成就。

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。