如何用PHP调用Gmail Postmaster Tools API获取域名trafficStats？

你已经成功获取域名列表，接下来调用domains.trafficStats.get接口，只需利用已初始化的PostmasterTools服务实例，调用对应方法即可：

核心代码示例 #

// 你已初始化好的PostmasterTools服务实例
$service = new \Google\Service\PostmasterTools($client);

// 指定目标域名，构造API要求的name参数格式：domains/{domain}
$targetDomain = "example.com"; // 替换成你的实际域名
$name = "domains/{$targetDomain}";

// 可选：设置查询日期范围（ISO 8601格式，如YYYY-MM-DD）
// 不指定则默认返回最近30天的数据
$queryParams = [
    'startDate' => '2024-01-01',
    'endDate' => '2024-01-31'
];

// 调用接口获取trafficStats数据
$trafficStats = $service->domains_trafficStats->get($name, $queryParams);

// 调试或提取具体指标
// 打印完整返回结果
print_r($trafficStats);
// 获取垃圾邮件率
echo "垃圾邮件率: " . $trafficStats->getSpamRate() . "\n";
// 获取送达率细分数据
$deliveryRate = $trafficStats->getDeliveryRate();
echo "收件箱接受率: " . $deliveryRate->getAcceptanceRate() . "\n";

关键注意事项 #

• 确保你的OAuth客户端已获得https://www.googleapis.com/auth/postmaster.readonly权限，且有权访问目标域名的Postmaster数据
• name参数必须严格遵循domains/{domain}格式，不能仅传入纯域名字符串
• startDate和endDate为可选参数，日期需符合ISO 8601格式，查询范围不能超过90天

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