API Reference

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

资源类型

  1. 成就
  2. 应用
  3. 事件
  4. 玩家
  5. 聊天室
  6. 得分
  7. 回合制对局

成就

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

方法 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 重置所有玩家的成就。此方法仅适用于您的开发者控制台的用户帐号。只能重置草稿成就。

应用

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

方法 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

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

方法 HTTP 请求 说明
除非另有说明,否则 URI 相对于 https://www.googleapis.com/games/v1management
重置 POST  /turnbasedmatches/reset 重置用户的所有回合制对局数据。只有您应用的已列入白名单的测试人员帐号才能访问此方法。
resetForAllPlayers POST  /turnbasedmatches/resetForAllPlayers 如果只有比赛参与者来自您应用的已列入白名单的测试人员帐号,则删除回合制对局。此方法仅适用于您的开发者控制台的用户帐号。