直接来自 Gmail 的真实投递数据
只有 Gmail 的数据(不覆盖 Outlook、Yahoo 等)
postmaster.google.com 验证域名所有权后启用 API。GET /v1/domains/{domain}/trafficStats 查投递统计。
可用率 · 30 天窗口
关于这个 API
Postmaster Tools 是 Google 给「发件方」准备的工具——任何大规模发邮件给 Gmail 用户的公司(SaaS 的交易通知、newsletter 平台、营销邮件商)都应该用这个。API 提供四类核心数据:spam rate(多少邮件被分类为 spam)、IP reputation(你的发件 IP 在 Gmail 眼里信誉如何)、domain reputation(域名信誉)、SPF/DKIM/DMARC 通过率(多少邮件通过了认证)。这些数据是诊断邮件投递问题的根本依据——如果发现 spam rate 突然升高,得快速查邮件内容、抵达模式、用户互动等多个因素,否则你的域名会被 Gmail 降级到 spam 文件夹。比 SendGrid 等 ESP 的"模糊指标"更权威,因为来自 Gmail 本身。
你可以做什么
- 1大规模邮件发送方监控 Gmail 投递质量
- 2排查邮件被分类为 spam 的原因
- 3配合 SendGrid/Mailgun 等做 deliverability 优化
- 4触发告警当 spam rate 异常
优劣对比
优点
- 直接来自 Gmail 的真实投递数据
- 区分 user-marked-spam vs filter-classified-spam
- 免费
注意事项
- 只有 Gmail 的数据(不覆盖 Outlook、Yahoo 等)
- 数据更新有 1-2 天延迟
- 小量发件人数据稀疏看不出趋势
示例请求
curl https://google.com/<endpoint>快速开始
postmaster.google.com 验证域名所有权后启用 API。GET /v1/domains/{domain}/trafficStats 查投递统计。
常见问题
怎么知道我的域名 reputation 受影响了?+
API 返回的 spamRate 长期 > 0.1% 就是 high;reputationCategory 为 LOW 或 BAD 就需要立即调查。
能拿到具体哪些邮件被分类为 spam 吗?+
不能。Postmaster Tools 只给聚合统计,单封邮件诊断需要查 ESP 的日志或在用户测试账户里抓。
技术细节
- 认证方式
- unknown
- 计费
- unknown
- 协议
- REST
- SDK
- python, javascript, go, java
- 响应时间
- 41 ms
- 上次巡检
- 2026/5/12 07:37:31
更多来自 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 让应用程序化创建、读取、更新日历事件,是日程类应用最常用的集成。