API 参考

本 API 参考按资源类型进行组织。每种资源类型都具有一个或多个数据表示形式以及一个或多个方法。

资源类型

  1. 成就
  2. 应用
  3. 事件
  4. 玩家
  5. 房间
  6. 分数
  7. 回合制匹配

成就

有关成就资源详情，请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
reset 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 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
listHidden GET  /applications/applicationId/players/hidden 获取从给定应用中隐藏的玩家列表。此方法仅供您开发者控制台的用户帐号使用。

事件

有关事件资源详情，请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
reset POST  /events/eventId/reset 为此应用的当前已通过身份验证的玩家重置具有给定 ID 的事件上的所有玩家进度。此方法仅供您应用的白名单测试员帐号使用。
resetAll POST  /events/reset 重置当前已通过身份验证的玩家在所有事件上的所有玩家进度。此方法仅供您应用的白名单测试员帐号使用。
resetForAllPlayers POST  /events/eventId/resetForAllPlayers 为所有玩家重置具有给定 ID 的事件。此方法仅供您开发者控制台的用户帐号使用。只有草稿事件可以重置。
resetAllForAllPlayers POST  /events/resetAllForAllPlayers 为所有玩家重置所有草稿事件。此方法仅供您开发者控制台的用户帐号使用。
resetMultipleForAllPlayers POST  /events/resetMultipleForAllPlayers 为所有玩家重置具有给定 ID 的事件。此方法仅供您开发者控制台的用户帐号使用。只有草稿事件可以重置。

玩家

有关玩家资源详情，请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
隐藏 POST  /applications/applicationId/players/hidden/playerId 将给定玩家的排行榜分数从给定应用中隐藏。此方法仅供您开发者控制台的用户帐号使用。
取消隐藏 DELETE  /applications/applicationId/players/hidden/playerId 将给定玩家的排行榜分数从给定应用中取消隐藏。此方法仅供您开发者控制台的用户帐号使用，可能需要一天时间才能生效。

房间

有关房间资源详情，请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
reset POST  /rooms/reset 为您应用的当前已通过身份验证的玩家重置所有房间。此方法仅供您应用的白名单测试员帐号使用。
resetForAllPlayers POST  /rooms/resetForAllPlayers 删除仅包含您应用的白名单测试员帐号作为房间参与者的房间。此方法仅供您开发者控制台的用户帐号使用。

分数

有关分数资源详情，请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
reset 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 的排行榜的分数。此方法仅供您开发者控制台的用户帐号使用。只有草稿排行榜可以重置。

回合制匹配

有关回合制匹配资源详情，请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明，URI 均相对于 https://www.googleapis.com/games/v1management
reset POST  /turnbasedmatches/reset 为用户重置所有回合制匹配数据。此方法仅供您应用的白名单测试员帐号使用。
resetForAllPlayers POST  /turnbasedmatches/resetForAllPlayers 删除仅包含您应用的白名单测试员帐号作为匹配参与者的回合制匹配。此方法仅供您开发者控制台的用户帐号使用。