Gmail REST API发送邮件JSON请求参数填写及调用问题咨询

你贴出的结构是 Gmail API 返回的完整 Message 对象格式，发送邮件时仅需填写极少数必填参数，其余字段均为接口返回时自动生成，无需手动传入。

核心参数说明 #

• 路径参数 userId：固定填写 me 即可，指代当前已授权的用户账号
• 请求体仅需填写 raw 字段即可完成基础邮件发送，其余字段均为可选

raw 字段生成规则 #

1. 先按照 RFC 2822 格式编写完整的邮件原文，示例如下：

From: 发件人名称 <你的邮箱地址@gmail.com>
To: 收件人名称 <收件人邮箱@example.com>
Subject: 测试邮件标题
Content-Type: text/plain; charset=utf-8

这里是邮件的正文内容

2. 将上述邮件原文做 UTF-8 编码后，再进行 Base64URL 编码（注意要替换普通Base64中的特殊字符：+ 换为 -、/ 换为 _，并删除末尾的 = 填充符）
3. 编码后的字符串直接填入 raw 字段即可

完整请求体示例 #

{
  "raw": "此处替换为你生成的Base64URL编码字符串"
}

可选参数说明 #

如果有特殊需求可以传入以下参数，无需求直接忽略即可：

• threadId：若需要将本次发送的邮件归入已有邮件线程，传入对应线程的ID
• labelIds：若需要给发送成功的邮件添加自定义标签，传入对应标签ID组成的数组

其余字段如 id、snippet、historyId、internalDate、payload、sizeEstimate 等均为接口返回时自动填充的属性，发送请求时无需传入，即使传入也会被系统忽略。

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