Spring Boot调用Gmail API发邮件报FAILED_PRECONDITION错误咨询

• 服务账号（格式为xxx@xxx.iam.gserviceaccount.com）是Google Cloud提供的程序调用专用身份，本身不绑定Gmail邮箱，不具备收发邮件的实体能力。你当前代码在createDelegated()方法和users().messages().send()接口的用户参数中传入的都是服务账号自身邮箱，Gmail API找不到对应可用的邮箱实体，直接触发FAILED_PRECONDITION前置校验失败。
• 配置缺失：你仅完成了Google Cloud侧的基础API配置，没有给服务账号开启Google Workspace域范围委托权限，就算修正了邮箱参数，也会因没有域用户操作权限被拦截。

• 给服务账号开启域委托权限
  1. 回到Google Cloud Console的凭证管理页，找到你创建的服务账号进入详情
  2. 展开高级设置，找到「Domain-wide delegation」板块，勾选启用G Suite域范围委托，保存后复制生成的客户端ID
• 给服务账号分配Gmail发信权限
  1. 用Google Workspace超级管理员账号进入管理后台，依次打开「安全」-「访问和数据控制」-「API控件」-「管理域范围委托」
  2. 新增授权项，粘贴之前复制的客户端ID，OAuth范围填入https://www.googleapis.com/auth/gmail.send，保存即可
• 提前准备好你租户下真实存在的Workspace用户邮箱作为发信邮箱（比如notice@你的企业域名.com），禁止使用服务账号邮箱作为发信人。

只需要修改两处参数，将原来传入服务账号邮箱的位置替换为你准备好的真实Workspace发信人邮箱即可：

1. 修正凭证委托的目标用户

credentials = ServiceAccountCredentials.fromStream(targetStream)
        .createScoped(Collections.singletonList(GmailScopes.GMAIL_SEND))
        // 替换为真实发信人邮箱
        .createDelegated("notice@yourdomain.com");

2. 修正发信接口的用户参数

// 第一个参数替换为和上面一致的真实发信人邮箱
message = service.users().messages().send("notice@yourdomain.com", message).execute();

额外提示：不要将服务账号的JSON密钥硬编码在业务代码中，生产环境建议将密钥文件存放在服务器受保护的目录下，通过文件流读取加载，避免私钥泄露。

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