Postmaster Tools API调用异常：Requested entity was not found问题求助

核心排查方向 #

1. 缺失必填日期参数 #

Gmail Postmaster Tools API的trafficStats.list接口必须指定startDate和endDate参数，未传入时可能触发不准确的notFound错误（而非明确的参数缺失提示）。

修正后的调用代码：

const details = await gmailpostmaster.domains.trafficStats.list({
  parent: "domains/example.com",
  // 设置与域名数据时间匹配的日期范围
  startDate: { year: 2025, month: 2, day: 3 },
  endDate: { year: 2025, month: 2, day: 10 }
});

2. 验证OAuth令牌权限范围 #

确认OAuth令牌实际包含postmaster.readonly权限，避免授权流程中权限未正确授予：

// 打印当前令牌的权限范围
console.log(oAuth2Client.credentials.scope);

若输出不包含https://www.googleapis.com/auth/postmaster.readonly，需重新发起OAuth授权流程，确保用户同意该权限。

3. 数据同步延迟 #

Postmaster Dashboard与API存在数据同步延迟，尤其是新添加的域名（你的域名创建时间为2025-02-03）。建议等待24小时后再尝试调用API，或在Dashboard中确认数据已稳定显示至少1天。

4. 域名资源名称正确性 #

虽然你从domains.list获取了name字段，但需确认域名是否为全小写格式（域名系统不区分大小写，但API可能严格匹配）。尝试将parent参数改为全小写的domains/example.com重试。

额外验证步骤 #

• 确认Google Cloud Console中已启用Gmail Postmaster Tools API（能获取域名列表说明已启用，但可再次核对）。
• 在API Playground测试时，务必手动添加startDate和endDate参数后再发起请求。

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