API Reference

本 API 參考資料是依照資源類型編排。各個資源類型都具有一或多種資料表示法，以及一或多種方法。

資源類型

1. 成就
2. 應用程式
3. 事件
4. 玩家
5. Rooms
6. 分數
7. 回合製比對

關卡

如需 Achievements 資源的詳細資料，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
重設	POST  /achievements/achievementId/reset	以目前已驗證玩家的指定 ID 重設成就。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetAll	POST  /achievements/reset	重設應用程式目前已驗證玩家的所有成就。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetForAllPlayers	POST  /achievements/achievementId/resetForAllPlayers	以指定 ID 重設所有玩家的關卡。這種方法僅適用於您開發人員控制台的使用者帳戶。只能重設草稿關卡。
resetAllForAllPlayers	POST  /achievements/resetAllForAllPlayers	重設所有玩家的草稿關卡。這個方法僅適用於您開發人員控制台的使用者帳戶。
resetMultipleForAllPlayers	POST  /achievements/resetMultipleForAllPlayers	為所有玩家重設具有指定 ID 的成就。這種方法僅適用於您開發人員控制台的使用者帳戶。只有草稿關卡才能重設。

應用程式

如要進一步瞭解應用程式資源，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
listHidden	GET  /applications/applicationId/players/hidden	取得從指定應用程式隱藏的玩家清單。這個方法僅適用於您開發人員控制台的使用者帳戶。

事件

如要進一步瞭解事件資源，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
重設	POST  /events/eventId/reset	針對目前已驗證的玩家，重設事件中的所有玩家進度。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetAll	POST  /events/reset	為目前已驗證的玩家重設所有事件的所有玩家進度。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetForAllPlayers	POST  /events/eventId/resetForAllPlayers	為所有玩家重設具有指定 ID 的事件。這種方法僅適用於您開發人員控制台的使用者帳戶。只有活動草稿可以重設。
resetAllForAllPlayers	POST  /events/resetAllForAllPlayers	重設所有玩家的所有草稿活動。這個方法僅適用於您開發人員控制台的使用者帳戶。
resetMultipleForAllPlayers	POST  /events/resetMultipleForAllPlayers	為所有玩家重設具有指定 ID 的事件。這種方法僅適用於您開發人員控制台的使用者帳戶。只能重設活動草稿。

玩家

如需玩家資源詳細資料，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
hide	POST  /applications/applicationId/players/hidden/playerId	隱藏指定應用程式的玩家排行榜分數。這個方法僅適用於您開發人員控制台的使用者帳戶。
取消隱藏	DELETE  /applications/applicationId/players/hidden/playerId	取消隱藏指定應用程式的玩家排行榜分數。這個方法只會提供給您開發人員控制台的使用者帳戶，而且最多可能需要一天才會生效。

聊天室

如要進一步瞭解 Rooms 資源，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
重設	POST  /rooms/reset	為應用程式重設目前已驗證玩家的所有空間。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetForAllPlayers	POST  /rooms/resetForAllPlayers	刪除應用程式聊天室中只有會議室參與者的許可清單。這個方法僅適用於您開發人員控制台的使用者帳戶。

分數

如需分數資源的詳細資料，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
重設	POST  /leaderboards/leaderboardId/scores/reset	針對目前已驗證的玩家，重設具有指定 ID 的排行榜分數。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetForAllPlayers	POST  /leaderboards/leaderboardId/scores/resetForAllPlayers	為所有玩家重設具有指定 ID 的排行榜分數。這種方法僅適用於您開發人員控制台的使用者帳戶。只有草稿排行榜可以重設。
resetAll	POST  /scores/reset	重設目前已驗證玩家的所有排行榜分數。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetAllForAllPlayers	POST  /scores/resetAllForAllPlayers	重設所有玩家的草稿排行榜分數。這個方法僅適用於您開發人員控制台的使用者帳戶。
resetMultipleForAllPlayers	POST  /scores/resetMultipleForAllPlayers	為所有玩家重設具有指定 ID 的排行榜分數。這種方法僅適用於您開發人員控制台的使用者帳戶。只有草稿排行榜才能重設。

TurnBasedMatches

如需 TurnBasedMatch 資源的詳細資料，請參閱資源表示法網頁。

方法	HTTP 要求	說明
與 https://www.googleapis.com/games/v1management 相對的 URI (除非另有註明)
重設	POST  /turnbasedmatches/reset	重設使用者的所有回合製比對資料。只有已加入許可清單的測試人員帳戶才能使用這個方法。
resetForAllPlayers	POST  /turnbasedmatches/resetForAllPlayers	刪除回合製比對，但只有符合條件的參與者來自您應用程式的許可清單測試人員帳戶。這個方法僅適用於您開發人員控制台的使用者帳戶。