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 刪除回合製比對，但只有符合條件的參與者來自您應用程式的許可清單測試人員帳戶。這個方法僅適用於您開發人員控制台的使用者帳戶。