解码Play Integrity Token时GoogleJsonResponseException(403)错误排查

权限配置要点 #

• 给服务账号配对应角色：
  进入Google Cloud控制台，找到你的项目，在「API和服务」→「凭据」页面，定位到调用API的服务账号，给它添加Play Integrity Viewer（仅用于解码验证）或Play Integrity Editor（可修改相关配置）角色。
• 确保密钥文件配置正确：
  你的Java项目必须正确加载服务账号的密钥文件，认证信息错误会直接导致权限验证失败。

Play控制台必做设置 #

• 关联Google Cloud项目：
  在Play控制台的「应用完整性」→「Play Integrity API」页面，将你的Google Cloud项目与当前应用绑定，两者未关联会触发权限拒绝。
• 包名必须完全匹配：
  代码中传入的包名（比如你用的com.test.android.integritysample），必须和Play控制台注册的应用包名、生成Integrity Token的应用包名完全一致，任何差异都会导致失败。
• 应用需完成发布：
  Play Integrity API要求应用至少发布到内部测试轨道，未发布的应用无法正常调用解码接口。

额外检查项 #

• 验证Token合法性：
  要解码的Integrity Token必须是对应包名的应用合法生成的，篡改或来自其他应用的Token也会触发权限拒绝。
• 确认API已启用：
  去Google Cloud控制台检查Play Integrity API是否已启用，未启用的话需先开启该API。

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