Google Play 遊戲服務可讓開發人員運用社交排行榜、成就、遊戲狀態、登入 Google 等功能,提升遊戲體驗。
- REST 資源: progressDefinitions
- REST 資源:成就
- REST 資源:應用程式
- REST 資源:事件
- REST 資源:排行榜
- REST 資源:Metagame
- REST 資源:Player
- REST 資源:喚回度
- REST 資源:修訂版本
- REST 資源:分數
- REST 資源:快照
- REST 資源:Stats
服務:games.googleapis.com
如要呼叫這項服務,建議您使用 Google 提供的用戶端程式庫。如果應用程式需要使用您自己的程式庫來呼叫這項服務,請在提出 API 要求時使用下列資訊。
探索文件
探索文件是一種機器可解讀的規格,用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式,以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件:
服務端點
服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點,且下方的 URI 皆以此服務端點為基準:
https://games.googleapis.com
REST 資源:achievementDefinitions
方法 | |
---|---|
list |
GET /games/v1/achievements 列出應用程式的所有成就定義。 |
REST 資源:關卡
方法 | |
---|---|
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 為目前已驗證的玩家更新多個成就。 |
REST 資源:applications
方法 | |
---|---|
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。 |
REST 資源:events
方法 | |
---|---|
listByPlayer |
GET /games/v1/events 針對目前已驗證的使用者,傳回應用程式事件目前進度的清單。 |
listDefinitions |
GET /games/v1/eventDefinitions 傳回這個應用程式中的事件定義清單。 |
record |
POST /games/v1/events 針對應用程式的目前驗證使用者事件發生次數,記錄一批變更資料。 |
REST 資源:排行榜
方法 | |
---|---|
get |
GET /games/v1/leaderboards/{leaderboardId} 擷取具有指定 ID 的排行榜中繼資料。 |
list |
GET /games/v1/leaderboards 列出應用程式的所有排行榜中繼資料。 |
REST 資源:metagame
方法 | |
---|---|
getMetagameConfig |
GET /games/v1/metagameConfig 傳回呼叫應用程式的中繼遊戲設定資料。 |
listCategoriesByPlayer |
GET /games/v1/players/{playerId}/categories/{collection} 列出 playerId 對應玩家依類別匯總的播放資料。 |
REST 資源:players
方法 | |
---|---|
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} 取得目前驗證使用者的玩家集合。 |
REST 資源:recall
方法 | |
---|---|
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 刪除透過召回工作階段識別的 PGS 玩家主體,以及由「人物角色」或符記值識別的遊戲內帳戶,藉此刪除喚回符記。 |
REST 資源:修訂版本
方法 | |
---|---|
check |
GET /games/v1/revisions/check 檢查遊戲用戶端是否版本過舊。 |
REST 資源:scores
方法 | |
---|---|
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 將多個分數提交至排行榜。 |
REST 資源:snapshots
方法 | |
---|---|
get |
GET /games/v1/snapshots/{snapshotId} 擷取特定快照 ID 的中繼資料。 |
list |
GET /games/v1/players/{playerId}/snapshots 擷取應用程式為與玩家 ID 相對應的玩家建立的快照清單。 |
REST 資源:stats
方法 | |
---|---|
get |
GET /games/v1/stats 針對目前已驗證的使用者,傳回這個應用程式中的參與度和支出統計資料。 |