nexus/wiki/concepts/Gmail-API.md

title, type, tags

title	type	tags
Gmail API	concept	google-workspace api email

Definition

Gmail API 是 Google 提供的编程接口，允许第三方应用程序通过 OAuth 2.0 认证访问 Gmail 邮件服务，实现搜索、读取、发送、管理邮件等功能。

Key Operations

操作	描述
messages.list	列出邮件列表
messages.get	获取邮件详情
messages.send	发送邮件
messages.modify	修改邮件标签
drafts.create	创建草稿
drafts.send	发送草稿

Prerequisites for Access

1. Google Cloud Console 中启用 Gmail API
2. 配置 OAuth 2.0 凭证（桌面应用类型）
3. 用户完成 OAuth 授权流程
4. 添加测试用户（未验证应用场景）

Common Error

• 403 accessNotConfigured：API 未在 Google Cloud Console 中启用
• 403 accessDenied：用户未完成 OAuth 授权

Related Concepts

• OAuth：认证机制
• Google-Cloud-Console：凭证配置
• 测试用户：绕过未验证应用限制
• API-Enablement：启用 API 的操作

Related Entities

• Google：API 提供方
• gog CLI：使用 Gmail API 的命令行工具