Google API Error 400（Precondition check failed）问题求助

这个错误的核心原因是服务账号或API配置未满足Gmail API的前置校验要求，以下是针对性排查步骤：

• 确认Gmail API已启用：登录Google Cloud控制台，搜索「Gmail API」，检查状态是否为「已启用」。若未启用，点击「启用」按钮完成激活，API启用可能需要几分钟生效。
• 检查服务账号的域范围委派（仅适用于Google Workspace账号）：
  • 若发件人邮箱属于Google Workspace域，需登录Workspace Admin控制台，进入「安全」>「API控制」>「域范围委派」。
  • 添加你的服务账号客户端ID，授权范围填写https://www.googleapis.com/auth/gmail.send，保存配置。
• 验证发件人邮箱的授权关系：服务账号无法直接使用普通Gmail邮箱作为发件人，仅支持Google Workspace域内的邮箱。若你使用的是普通Gmail，需切换为Workspace邮箱，或改用Gmail SMTP服务（搭配OAuth2客户端凭证）。
• 核对代码中的配置细节：
  • 确保PHP代码中加载的JSON密钥文件是你从Google Cloud导出的正确文件，路径无拼写错误。
  • 确认代码中指定的发件人邮箱与服务账号关联的邮箱（或已授权的Workspace邮箱）完全一致。
• 验证gcloud授权状态：执行gcloud auth list命令，查看当前激活的服务账号是否为你配置的目标账号。若不是，重新执行gcloud auth activate-service-account --key-file=你的密钥文件路径.json完成激活。
• 检查API请求格式：Gmail API要求发送的邮件内容需符合RFC 2822格式，并进行Base64编码。确保你的PHP代码正确构造了邮件对象，包含必填的收件人、主题、正文等字段，编码格式无误（注意使用URL安全的Base64编码）。
• 查看详细日志信息：登录Google Cloud控制台的「日志资源管理器」，筛选Gmail API相关请求，查看具体的错误详情，日志中可能会提示未满足的具体前置条件（如权限缺失、邮箱未授权等）。

内容的提问来源于stack exchange，提问作者Mostepha Amine Bdeira