API 参考

此 API 参考按资源类型组织。每种资源类型都具有一个或多个数据表示和一个或多个方法。

资源类型

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

成就

有关成就资源的详细信息，请参阅资源表示页面。

方法 HTTP 请求 描述
相对于 https://www.googleapis.com/games/v1management 的 URI，除非另有说明
重置 POST  /achievements/achievementId/reset 重置当前已验证玩家的指定 ID 成就。此方法仅供应用的白名单测试帐号访问。
全部重置 POST  /achievements/reset 重置当前已验证玩家应用中的所有成就。此方法仅供应用的白名单测试帐号访问。
重置所有玩家 POST  /achievements/achievementId/resetForAllPlayers 重置所有玩家的指定 ID 成就。此方法仅供您开发者控制台的用户帐号使用。只有草稿成就才能重置。
全部重置所有玩家 POST  /achievements/resetAllForAllPlayers 重置所有玩家的所有草稿成就。此方法仅供您开发者控制台的用户帐号使用。
重置所有玩家的多个成就 POST  /achievements/resetMultipleForAllPlayers 重置所有玩家的指定 ID 成就。此方法仅供您开发者控制台的用户帐号使用。只有草稿成就才能重置。

应用

有关应用资源的详细信息，请参阅资源表示页面。

方法 HTTP 请求 描述
相对于 https://www.googleapis.com/games/v1management 的 URI，除非另有说明
列出隐藏的玩家 GET  /applications/applicationId/players/hidden 获取从指定应用中隐藏的玩家列表。此方法仅供您开发者控制台的用户帐号使用。

事件

有关事件资源的详细信息，请参阅资源表示页面。

方法 HTTP 请求 描述
相对于 https://www.googleapis.com/games/v1management 的 URI，除非另有说明
重置 POST  /events/eventId/reset 重置当前已验证玩家在指定 ID 事件上的所有玩家进度。此方法仅供应用的白名单测试帐号访问。
全部重置 POST  /events/reset 重置当前已验证玩家在所有事件上的所有玩家进度。此方法仅供应用的白名单测试帐号访问。
重置所有玩家 POST  /events/eventId/resetForAllPlayers 重置所有玩家的指定 ID 事件。此方法仅供您开发者控制台的用户帐号使用。只有草稿事件才能重置。
全部重置所有玩家 POST  /events/resetAllForAllPlayers 重置所有玩家的所有草稿事件。此方法仅供您开发者控制台的用户帐号使用。
重置所有玩家的多个成就 POST  /events/resetMultipleForAllPlayers 重置所有玩家的指定 ID 事件。此方法仅供您开发者控制台的用户帐号使用。只有草稿事件才能重置。

玩家

有关玩家资源的详细信息，请参阅资源表示页面。

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

房间

有关房间资源的详细信息，请参阅资源表示页面。

方法 HTTP 请求 描述
相对于 https://www.googleapis.com/games/v1management 的 URI，除非另有说明
重置 POST  /rooms/reset 重置当前已认证玩家应用中的所有房间。此方法仅限于您的应用的白名单测试帐户访问。
重置所有玩家 POST  /rooms/resetForAllPlayers 删除只有白名单测试帐户参与的房间。此方法仅限于您的开发者控制台的用户帐户使用。

分数

有关分数资源的详细信息，请参见资源表示页面。

方法 HTTP 请求 描述
相对于 https://www.googleapis.com/games/v1management 的 URI，除非另有说明
重置 POST  /leaderboards/leaderboardId/scores/reset 重置当前已认证玩家给定 ID 的排行榜的分数。此方法仅限于您的应用的白名单测试帐户访问。
重置所有玩家 POST  /leaderboards/leaderboardId/scores/resetForAllPlayers 重置所有玩家给定 ID 的排行榜的分数。此方法仅限于您的开发者控制台的用户帐户使用。只有草稿排行榜才能重置。
全部重置 POST  /scores/reset 重置当前已认证玩家所有排行榜的所有分数。此方法仅限于您的应用的白名单测试帐户访问。
全部重置所有玩家 POST  /scores/resetAllForAllPlayers 重置所有玩家所有草稿排行榜的分数。此方法仅限于您的开发者控制台的用户帐户使用。
重置所有玩家的多个成就 POST  /scores/resetMultipleForAllPlayers 重置所有玩家给定 ID 的排行榜的分数。此方法仅限于您的开发者控制台的用户帐户使用。只有草稿排行榜才能重置。

回合制匹配

有关回合制匹配资源的详细信息，请参见资源表示页面。

方法 HTTP 请求 描述
相对于 https://www.googleapis.com/games/v1management 的 URI，除非另有说明
重置 POST  /turnbasedmatches/reset 重置用户的全部回合制匹配数据。此方法仅限于您的应用的白名单测试帐户访问。
重置所有玩家 POST  /turnbasedmatches/resetForAllPlayers 删除只有白名单测试帐户参与的回合制匹配。此方法仅限于您的开发者控制台的用户帐户使用。