配额慷慨——每用户每天 10 亿 quota units
必须走 OAuth 流程，不能用简单 API key 调用
到 console.cloud.google.com 创建项目，启用 Gmail API，配置 OAuth consent screen 与 credentials。代码端用 OAuth 2.0 拿 access_token，调 https://gmail.googleapis.com/gmail/v1/users/me/... 各端点。需要范围如 https://www.googleapis.com/auth/gmail.readonly。
可用率 · 30 天窗口
关于这个 API
Gmail API 是 Google Workspace 生态中最常用的 API 之一，提供完整的邮箱编程能力：读写邮件、管理标签、操作草稿、查询邮件搜索语法、监听新邮件事件。和直接对接 IMAP/SMTP 相比，Gmail API 是结构化的 JSON 接口，速率配额更高，且能监听增量变更而不需轮询。
认证只有一条路：OAuth 2.0。这意味着你需要在 Google Cloud Console 注册 OAuth client，让用户授权，拿 refresh_token 长期使用。Workspace 域管理员可以为整个组织授权 service account（domain-wide delegation），适合做企业内部工具。
邮件主体以 base64url 编码的 RFC 2822 MIME 存储——读取 attachments 或 HTML 内容需要解析 MIME 树。Gmail API 提供 history 接口做增量同步：第一次全量拉，之后用 history_id 只拉变更。push notifications 通过 Pub/Sub 实时通知，避免反复 long-poll。配额按 quota units 计算，普通操作 5 units，发送 100 units，每用户每天 10 亿 quota units，对绝大多数应用绰绰有余。
你可以做什么
- 1搭建邮件客户端或邮件分类工具
- 2将关键邮件同步到外部 CRM / 工单系统
- 3按规则自动归档、贴标、转发邮件
- 4为应用提供"用 Gmail 发送"的合规通道
- 5生成邮件智能摘要与回复建议
优劣对比
优点
- 配额慷慨——每用户每天 10 亿 quota units
- push notifications 通过 Pub/Sub 实时通知新邮件
- 与 Workspace 其他 API（Calendar、Drive）共享 OAuth scope 模型
注意事项
- 必须走 OAuth 流程，不能用简单 API key 调用
- 消息体是 base64url 编码 MIME，解析略繁琐
- 发送速率有反垃圾上限（约 250 封/秒/账户）
示例请求
curl https://google.com/<endpoint> \
-H "Authorization: Bearer $ACCESS_TOKEN"快速开始
到 console.cloud.google.com 创建项目，启用 Gmail API，配置 OAuth consent screen 与 credentials。代码端用 OAuth 2.0 拿 access_token，调 https://gmail.googleapis.com/gmail/v1/users/me/... 各端点。需要范围如 https://www.googleapis.com/auth/gmail.readonly。
常见问题
Gmail API 收费吗？+
免费使用，配额按 quota units 计算。普通应用极难触达上限。
能不通过用户授权用我的服务账号发邮件吗？+
只能在 Google Workspace 内通过 domain-wide delegation 让管理员授权 service account 代表组织内用户操作。
如何监听新邮件？+
用 Watch API 订阅 Pub/Sub 主题；新邮件触发 push，再用 history.list 拉变更 ID。
OAuth consent screen 需要 Google 审核吗？+
使用敏感 scope（如 gmail.readonly）的应用上线前需要通过 Google verification 流程，时间可能 2-6 周。
技术细节
- 认证方式
- oauth
- 计费
- free
- 协议
- REST
- SDK
- python, javascript, java, go, ruby
- 响应时间
- 42 ms
- 上次巡检
- 2026/5/12 07:37:31
接口端点
从 OpenAPI spec 自动解析。显示 12 / 79 个未弃用端点。
/gmail/v1/users/{userId}/draftsusers/gmail/v1/users/{userId}/draftsusers/gmail/v1/users/{userId}/drafts/{id}users/gmail/v1/users/{userId}/drafts/{id}users/gmail/v1/users/{userId}/drafts/{id}users/gmail/v1/users/{userId}/drafts/sendusers/gmail/v1/users/{userId}/historyusers/gmail/v1/users/{userId}/labelsusers/gmail/v1/users/{userId}/labelsusers/gmail/v1/users/{userId}/labels/{id}users/gmail/v1/users/{userId}/labels/{id}users/gmail/v1/users/{userId}/labels/{id}users另有 67 个端点未显示，详见 OpenAPI spec。
更多来自 Google 的 API
Google Workspace Admin SDK API 程序化管理 Workspace 组织：用户、组、设备、域名、审计日志、组织单元。
AdMob API 可读取 accounts、apps、adUnits 与 adSources，并生成 mediation 与 network 报表。
AdSense Host API 支持 accounts、adclients、adunits、reports 和 adcode 生成，适合托管式广告平台集成。
Apigee API 可管理 API proxy、deployments、attributes 与 organizations，适合把 API 网关运维接入自动化流程。
Google BigQuery API 是 GCP 旗舰数据仓库的 REST 接口：执行 SQL 查询、管理 datasets/tables、流式插入、ML 内置。
Binary Authorization API 用于管理 attestors、IAM policy 与镜像验证流程，面向 GKE 和 Anthos 的发布门禁。
Business Profile Performance API 能拉取 location 指标时间序列和 search keyword impressions，服务 Google 商家资料分析。
Google Calendar API 让应用程序化创建、读取、更新日历事件，是日程类应用最常用的集成。