列出應用程式所有成就的目前驗證玩家進度。
HTTP 要求
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
路徑參數
參數 | |
---|---|
playerId |
玩家 ID。 |
查詢參數
參數 | |
---|---|
language |
此方法傳回的字串偏好語言。 |
maxResults |
回應中要傳回的關卡資源數量上限,用於分頁。對任何回應,實際傳回的關卡資源數量可能會少於指定的 |
pageToken |
上一個要求傳回的權杖。 |
state |
指示伺服器僅傳回具有指定狀態的成就。如未指定這個參數,則會傳回所有成就。 |
要求主體
要求主體必須為空白。
回應主體
關卡物件清單。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
nextPageToken |
與下一頁結果相對應的權杖。 |
items[] |
成就。 |
授權範圍
需要下列其中一種 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 ( |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
id |
關卡的 ID。 |
currentSteps |
目前累計成就。 |
formattedCurrentStepsString |
以字串形式顯示的漸進式成就目前步驟。 |
achievementState |
成就的狀態。 |
lastUpdatedTimestamp |
上次修改此關卡狀態的時間戳記。 |
experiencePoints |
達成成就並獲得成就積分。這個欄位不會顯示尚未解鎖的成就;如果測試人員已解鎖,但尚未發布的成就,則系統不會顯示這個欄位。 |
狀態
定義關卡的可能狀態,
列舉 | |
---|---|
HIDDEN |
已隱藏成就。 |
REVEALED |
成果已揭示, |
UNLOCKED |
已解鎖成就。 |