針對目前驗證玩家的所有應用程式成就,列出進度。
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 |
成就已解鎖。 |