Google Play Game Services

Google Play 遊戲服務可讓開發人員利用社交排行榜、成就、遊戲狀態、使用 Google 帳戶登入等功能，提升遊戲體驗。

服務：games.googleapis.com

如要呼叫這項服務，建議您使用 Google 提供的用戶端程式庫。如果應用程式必須使用您自己的程式庫來呼叫這項服務，請在發出 API 要求時使用下列資訊。

探索文件是一種機器可解讀的規格，用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式，以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件：

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點，且下方的 URI 皆以此服務端點為基準：

方法
`list`	`GET /games/v1/achievements` 列出應用程式的所有成就定義。

方法
`increment`	`POST /games/v1/achievements/{achievementId}/increment` 使用目前驗證的玩家指定 ID 增加關卡步驟。
`list`	`GET /games/v1/players/{playerId}/achievements` 列出目前驗證玩家的所有應用程式成就進度。
`reveal`	`POST /games/v1/achievements/{achievementId}/reveal` 針對目前驗證的玩家，將具有指定 ID 的成就狀態設為 `REVEALED`。
`setStepsAtLeast`	`POST /games/v1/achievements/{achievementId}/setStepsAtLeast` 設定目前驗證玩家解鎖成就的步驟。
`unlock`	`POST /games/v1/achievements/{achievementId}/unlock` 為目前驗證的玩家解鎖這項成就。
`updateMultiple`	`POST /games/v1/achievements/updateMultiple` 為目前驗證的玩家更新多個成就。

方法
`get`	`GET /games/v1/applications/{applicationId}` 使用指定 ID 擷取應用程式的中繼資料。
`getEndPoint`	`POST /games/v1/applications/getEndPoint` 傳回所要求端點類型的網址。
`played`	`POST /games/v1/applications/played` 表示目前已通過驗證的使用者正在玩您的應用程式。
`verify`	`GET /games/v1/applications/{applicationId}/verify` 驗證此要求提供的驗證權杖適用於具備指定 ID 的應用程式，並傳回獲得玩家授權的玩家 ID。

方法
`listByPlayer`	`GET /games/v1/events` 傳回清單，顯示目前已通過驗證的使用者在這個應用程式中的事件進度。
`listDefinitions`	`GET /games/v1/eventDefinitions` 傳回此應用程式中的事件定義清單。
`record`	`POST /games/v1/events` 記錄這個應用程式目前已驗證使用者的大量事件發生次數。

方法
`get`	`GET /games/v1/leaderboards/{leaderboardId}` 擷取具有指定 ID 的排行榜中繼資料。
`list`	`GET /games/v1/leaderboards` 列出應用程式的所有排行榜中繼資料。

方法
`getMetagameConfig`	`GET /games/v1/metagameConfig` 傳回呼叫應用程式的中繼遊戲設定資料。
`listCategoriesByPlayer`	`GET /games/v1/players/{playerId}/categories/{collection}` 列出與 `playerId` 相對應的玩家依類別匯總的播放資料。

方法
`get`	`GET /games/v1/players/{playerId}` 擷取具有指定 ID 的玩家資源。
`getMultipleApplicationPlayerIds`	`GET /games/v1/players/me/multipleApplicationPlayerIds` 取得由呼叫應用程式相同的開發人員所要求所有遊戲，且目前通過驗證的玩家的應用程式玩家 ID。
`getScopedPlayerIds`	`GET /games/v1/players/me/scopedIds` 擷取目前已驗證使用者的範圍玩家 ID。
`list`	`GET /games/v1/players/me/players/{collection}` 取得目前驗證使用者的玩家集合。

方法
`linkPersona`	`POST /games/v1/recall:linkPersona` 將所提供召回工作階段 ID 中編碼的 PGS 玩家主體與遊戲內帳戶建立關聯
`resetPersona`	`POST /games/v1/recall:resetPersona` 刪除所有將特定使用者角色連結至任何玩家的召回權杖 (無論是否有設定檔)。
`retrieveTokens`	`GET /games/v1/recall/tokens/{sessionId}` 擷取與所提供召回工作階段 ID 中編碼的 PGS 玩家主體關聯的所有召回權杖。
`unlinkPersona`	`POST /games/v1/recall:unlinkPersona` 刪除召回權杖連結，連結以召回工作階段識別的 Play 遊戲服務玩家主體，以及由「人物角色」或權杖值識別的遊戲內帳戶。

方法
`check`	`GET /games/v1/revisions/check` 檢查遊戲用戶端是否版本過舊。

方法
`get`	`GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}` 立即在目前驗證玩家的排行榜中取得最高分，並視情況取得排名。
`list`	`GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}` 從頂端列出排行榜的分數。
`listWindow`	`GET /games/v1/leaderboards/{leaderboardId}/window/{collection}` 列出 (及包含) 玩家得分的排行榜中的得分。
`submit`	`POST /games/v1/leaderboards/{leaderboardId}/scores` 將分數提交至指定的排行榜。
`submitMultiple`	`POST /games/v1/leaderboards/scores` 將多個分數提交至排行榜。

方法
`get`	`GET /games/v1/snapshots/{snapshotId}` 擷取指定快照 ID 的中繼資料。
`list`	`GET /games/v1/players/{playerId}/snapshots` 擷取應用程式針對玩家 ID 對應的玩家所建立的快照清單。

方法
`get`	`GET /games/v1/stats` 針對目前已驗證的使用者，傳回這個應用程式中的參與度和支出統計資料。