Google Play Games成就与排行榜API100%调用失败排查求助

• 检查API启用状态：确认Google Cloud控制台中，Google Play Games Services API（games.googleapis.com）已启用。关联Firebase后可能未自动开启，需手动在API库搜索并启用。

• 验证OAuth 2.0客户端配置：

  • 检查Google Cloud控制台的OAuth 2.0客户端ID，确保对应游戏的Android类型客户端ID，已同时添加上传证书和应用签名证书的SHA-1指纹，且包名与游戏包名完全匹配。
  • 确认客户端ID无错误的限制条件（如错误包名、指纹）。

• 核对Play Console游戏服务配置：

  • 进入Play Console游戏服务页面，确认成就、排行榜的ID与代码中调用的完全一致（注意大小写、特殊字符，拼写错误是常见诱因）。
  • 确保测试账号已添加到游戏服务的授权测试列表（未发布游戏仅授权账号可调用API）。
  • 检查游戏服务发布状态：若为测试版本，需完成“准备测试”步骤，生成测试链接或授权账号。

• 检查API调用的权限与认证：

  • 确认调用API时使用的是已通过Play Games完整认证的玩家账号，必须完成Play Games登录流程，获取有效GamesSignInClient凭证（不能仅用Firebase匿名或其他第三方认证）。
  • 检查登录时请求的权限范围是否正确，成就/排行榜需https://www.googleapis.com/auth/games或https://www.googleapis.com/auth/games_lite权限。

• 分析API错误日志：

  • 在Google Cloud控制台的API详情页，查看具体错误码和信息：
    • 403：多为权限配置问题，如客户端ID不匹配、测试账号未授权、API未启用。
    • 404：通常是成就/排行榜ID错误，或游戏服务未正确关联/发布。
    • 401：认证凭证无效，如登录流程未完成、客户端ID错误。

• 确认Firebase与Play Games关联状态：

  • 检查Firebase控制台，确认应用已正确关联到对应Google Play Games服务项目，且关联项目与Google Cloud控制台项目一致（跨项目关联会导致权限不互通）。
  • 确认Firebase Authentication中，Google Play Games登录提供商已启用，且配置的客户端ID与Play Games的客户端ID一致。

内容的提问来源于stack exchange，提问作者modernator