API Reference

此 API 参考文档按资源类型编排整理。每种资源类型都有一种或多种数据表示形式以及一个或多个方法。

资源类型

  1. 成就
  2. 应用
  3. 事件
  4. 玩家
  5. 房间
  6. 评分
  7. TurnBasedMatches

成就

如需详细了解 Achievements 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
重置 POST  /achievements/achievementId/reset 为当前已通过身份验证的玩家重置具有指定 ID 的成就。只有已列入应用的白名单的测试人员账号才能使用此方法。
resetAll POST  /achievements/reset 重置应用当前已通过身份验证的玩家的所有成就。只有已列入应用白名单的测试人员账号才能使用此方法。
resetForAllPlayers POST  /achievements/achievementId/resetForAllPlayers 为所有玩家重置具有给定 ID 的成就。此方法仅适用于开发者控制台的用户账号。只有草稿成就才能重置。
resetAllForAllPlayers POST  /achievements/resetAllForAllPlayers 重置所有玩家的所有草稿成就。此方法仅适用于开发者控制台的用户账号。
resetMultipleForAllPlayers POST  /achievements/resetMultipleForAllPlayers 为所有玩家重置具有给定 ID 的成就。此方法仅适用于开发者控制台的用户账号。只能重置草稿成就。

应用

如需详细了解 Applications 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
listHidden GET  /applications/applicationId/players/hidden 获取从给定应用中隐藏的玩家的列表。此方法仅适用于开发者控制台的用户账号。

事件

如需详细了解 Events 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
重置 POST  /events/eventId/reset 针对当前已通过身份验证的玩家,重置指定 ID 的活动的所有玩家进度。只有已列入应用白名单的测试人员账号才能使用此方法。
resetAll POST  /events/reset 重置当前已通过身份验证的玩家在所有活动中的所有玩家进度。只有已列入应用的白名单的测试人员账号才能使用此方法。
resetForAllPlayers POST  /events/eventId/resetForAllPlayers 为所有玩家重置具有指定 ID 的事件。此方法仅适用于开发者控制台的用户账号。只有草稿事件可以重置。
resetAllForAllPlayers POST  /events/resetAllForAllPlayers 重置所有玩家的所有选秀事件。此方法仅适用于开发者控制台的用户账号。
resetMultipleForAllPlayers POST  /events/resetMultipleForAllPlayers 为所有玩家重置具有指定 ID 的事件。此方法仅适用于开发者控制台的用户账号。只能重置草稿活动。

玩家

如需详细了解 Players 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
隐藏 POST  /applications/applicationId/players/hidden/playerId 从给定应用中隐藏给定玩家的排行榜得分。此方法仅适用于开发者控制台的用户账号。
取消隐藏 DELETE  /applications/applicationId/players/hidden/playerId 取消隐藏给定应用中给定玩家的排行榜得分。此方法仅适用于开发者控制台的用户账号,且最长可能需要 1 天才会生效。

客房

如需详细了解 Rooms 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
重置 POST  /rooms/reset 为应用当前已通过身份验证的玩家重置所有房间。只有已列入应用的白名单的测试人员账号才能使用此方法。
resetForAllPlayers POST  /rooms/resetForAllPlayers 删除聊天室中仅有应用的已列入白名单的测试人员账号的参与者。此方法仅适用于开发者控制台的用户账号。

得分

如需详细了解 Scores 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
重置 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 资源,请参阅资源表示形式页面。

方法 HTTP 请求 说明
除非另有说明,否则 URI 均为 https://www.googleapis.com/games/v1management 的相对地址
重置 POST  /turnbasedmatches/reset 重置用户的所有轮替匹配数据。只有已列入应用白名单的测试人员账号才能使用此方法。
resetForAllPlayers POST  /turnbasedmatches/resetForAllPlayers 删除仅由应用的已列入白名单的测试人员账号参与的回合制匹配。此方法仅适用于开发者控制台的用户账号。