使用Gmail API以服务账号发邮件时遇400预检查失败错误

核心问题原因 #

服务账号本身没有独立的Gmail邮箱存储空间，无法直接以服务账号身份创建邮件草稿。你当前代码中使用userId="myuserid"（服务账号ID）调用API，不符合Gmail API的使用规则——服务账号必须通过域范围委派模拟一个Google Workspace（原G Suite）域内的真实用户，才能操作该用户的Gmail邮箱。

具体解决步骤 #

1. 确认域范围委派配置

   • 登录Google Workspace管理控制台，找到你的服务账号，开启域范围委派，并确保已添加https://mail.google.com/这个授权范围。
   • 注意：只有Google Workspace域内的账号才能使用域范围委派，普通个人Gmail账号不支持此功能。

2. 修改代码中的授权与用户ID

   • 创建服务账号凭证时，添加subject参数，指定要模拟的Workspace用户邮箱（比如your-user@your-domain.com）。
   • 将userId改为"me"（自动映射到当前授权的模拟用户），或者直接填写模拟的用户邮箱。

修改后的完整代码 #

import base64
from google.oauth2 import service_account
from email.message import EmailMessage
from googleapiclient.discovery import build

# 替换为你的服务账号密钥文件路径、模拟用户邮箱
creds = service_account.Credentials.from_service_account_file(
    filename='client_secret.json',
    scopes=['https://mail.google.com/'],
    subject='your-user@your-domain.com'  # 指定要模拟的Workspace用户
)

service = build('gmail', 'v1', credentials=creds)
mime_message = EmailMessage()
mime_message['To'] = 'receiving_accont@gmail.com'
# 发件人会显示为模拟的Workspace用户，若要自定义名称可设置为"自定义名称 <your-user@your-domain.com>"
mime_message['From'] = 'your-user@your-domain.com'
mime_message['Subject'] = 'Test Subject'
mime_message.set_content('Test Message')

encoded_message = base64.urlsafe_b64encode(mime_message.as_bytes()).decode()
create_draft_request_body = {
    'message': {'raw': encoded_message}
}
# 使用"me"作为userId，对应模拟的用户
draft = service.users().drafts().create(userId="me", body=create_draft_request_body).execute()

print(f"Draft created successfully: {draft}")

额外注意事项 #

• 若你没有Google Workspace账号，无法使用服务账号直接操作Gmail，建议改用OAuth 2.0授权码流程，让用户手动授权应用访问其Gmail。
• 确保模拟的Workspace用户拥有正常的Gmail权限，且服务账号的域范围委派配置已保存生效（可能需要等待几分钟）。

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