本頁面由 Cloud Translation API 翻譯而成。

Google Play Game Services

Google Play 遊戲服務可讓開發人員運用社交排行榜、成就、遊戲狀態、使用 Google 登入等功能改善遊戲體驗。

服務：games.googleapis.com

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

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

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

方法
`generatePlayGroupingApiToken`	`POST /games/v1/accesstokens/generatePlayGroupingApiToken` 個為 PGS 使用者產生 Play Grouping API 權杖 (透過附加憑證識別)。
`generateRecallPlayGroupingApiToken`	`POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken` 個以要求中提供的喚回工作階段 ID 識別 PGS 使用者，為 PGS 使用者產生 Play Grouping API 權杖。

方法
`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 的玩家 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` 個傳回呼叫應用程式的 Metagame 設定資料。
`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}` 個取得目前已驗證使用者的玩家集合。

方法
`gamesPlayerTokens`	`GET /games/v1/recall/gamesPlayerTokens/{sessionId}` 個從所有與 PGS 玩家相關聯的要求遊戲中擷取喚回符記 (透過提供的喚回工作階段 ID 編碼)。
`lastTokenFromAllDeveloperGames`	`GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}` 個從所有與 PGS 玩家相關聯的開發人員遊戲中擷取最後一個喚回符記 (使用提供的喚回工作階段 ID 編碼)。
`linkPersona`	`POST /games/v1/recall:linkPersona` 個將所提供召回工作階段 ID 中編碼的 PGS 玩家主體與遊戲內帳戶建立關聯
`resetPersona`	`POST /games/v1/recall:resetPersona` 個刪除將指定人物角色連結至任何玩家的所有喚回符記 (無論是否有個人資料)。
`retrieveTokens`	`GET /games/v1/recall/tokens/{sessionId}` 個擷取與 PGS 玩家相關聯的所有喚回符記 (透過提供的喚回工作階段 ID 編碼)。
`unlinkPersona`	`POST /games/v1/recall:unlinkPersona` 個刪除連結 PGS 玩家主體 (由喚回工作階段所識別) 和以「人物角色」識別的遊戲內帳戶。或是依據符記值

方法
`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` 個傳回目前驗證使用者的這個應用程式的參與度和支出統計資料。