使用Gmail API删除邮件遇403权限不足，请求指导Google Cloud授权

算力阿峰

2026-7-14

解决Gmail API删除邮件的403权限不足问题

这个403错误的核心原因是你的访问令牌缺少删除邮件所需的权限范围（Scope），Gmail API对不同操作要求对应权限，以下是具体解决步骤：

1. 在Google Cloud控制台配置权限范围

打开Google Cloud控制台，定位到你的项目
进入「API和服务」→「OAuth同意屏幕」，确认已添加正确的权限范围
在「已授权的范围」中添加以下任一权限（按需选择，推荐最小权限原则）：
- https://www.googleapis.com/auth/gmail.delete：仅允许删除邮件（最小权限，优先推荐）
- https://www.googleapis.com/auth/gmail.modify：允许修改邮件（含删除、标记等操作）
- https://mail.google.com/：完全访问Gmail（权限最高，适合全功能场景）
保存配置：若为测试应用，确保已添加测试用户；若为已发布应用，可能需重新提交审核

2. 更新代码中的权限范围

在初始化Gmail客户端的代码中，替换原有的权限范围为上述指定的scope。以Java代码为例：

List<String> scopes = Arrays.asList("https://www.googleapis.com/auth/gmail.delete");
GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
    HTTP_TRANSPORT, JSON_FACTORY, clientSecrets, scopes)
    .setDataStoreFactory(dataStoreFactory)
    .setAccessType("offline")
    .build();