使用Gmail API创建草稿时遭遇403权限不足错误求助

核心原因 #

你遇到的insufficientPermissions错误，本质是OAuth2客户端未获得创建草稿所需的权限，或是旧授权令牌不包含对应权限。

解决步骤 #

1. 配置正确的OAuth2权限范围 #

创建Gmail草稿需要以下权限之一（按权限从窄到宽排序，推荐用最小必要权限）：

• https://www.googleapis.com/auth/gmail.compose：仅允许创建、修改草稿及发送邮件
• https://www.googleapis.com/auth/gmail.modify：包含草稿操作，还支持修改邮件标签等
• https://mail.google.com/：全Gmail权限（不推荐，除非需要完整操作权限）

确保初始化OAuth2客户端时指定了正确的scope，示例代码：

const scopes = [
  'https://www.googleapis.com/auth/gmail.compose'
];

// 生成授权URL时使用这些scopes
const authUrl = oauth2Client.generateAuthUrl({
  access_type: 'offline',
  scope: scopes
});

2. 重新获取授权令牌 #

如果之前完成过授权但后续修改了权限范围，旧令牌不会自动更新权限。需要：

• 清除本地保存的旧令牌（比如文件或数据库中存储的tokens）
• 重新引导用户完成授权流程，获取包含新权限的令牌

3. 检查Google Cloud项目配置 #

确认你的Google Cloud项目已启用Gmail API：

• 登录Google Cloud控制台，找到对应项目
• 进入「API与服务」→「库」，搜索Gmail API并确保状态为「已启用」

4. 优化代码冗余字段 #

代码中requestBody里的id: ""是多余的，创建草稿时无需指定ID，API会自动生成，简化后的请求体：

requestBody: {
    message: {
        raw: "LS0tLQpGcm9tOiBKb2huIERvZSA8c0BnbWFpbC5jb20+ClRvOiBNYXJ5IFNtaXRoIDxzQGdtYWlsLmNvbT4KU3ViamVjdDogU2F5aW5nIEhlbGxvCkRhdGU6IEZyaSwgMjEgTm92IDE5OTcgMDk6NTU6MDYgLTA2MDAKTWVzc2FnZS1JRDogPDEyMzRAbG9jYWwubWFjaGluZS5leGFtcGxlPgoKaGVsbG8KLS0tLQ=="
    }
}

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