已迁移至Gmail API新批量端点仍收到全局HTTP批量端点停用通知邮件

别着急，这种情况我在日常排查中碰到过好几次，大概率是还有一些隐藏的细节没处理到位，或者遗留的调用没更新。给你列几个核心排查方向：

• 检查遗留的全局端点调用：有没有旧代码分支、定时任务、测试脚本或者第三方集成还在调用https://www.googleapis.com/batch这个全局端点？比如有些团队会把备份脚本、线下调试工具忘在一边，这些隐藏的调用很容易触发谷歌的提醒。
• 核实批量请求内的子请求路径：哪怕你用了新的批量端点，如果子请求的URL有问题也会被误判。要确保每个子请求都是指向Gmail API的具体资源，比如GET /gmail/v1/users/me/messages，而不是嵌套使用/batch路径。
• 确认请求头的Content-Type规范：新的Gmail专属批量端点要求请求头必须是multipart/mixed; boundary=你的边界值，而且边界值要和请求体里的分隔符完全一致。如果还在用旧的multipart/related或者格式不匹配，可能会被谷歌判定为使用全局端点。
• 排查缓存或代理的影响：如果你的请求经过CDN、代理服务器或者本地缓存，可能存在旧请求路径的缓存，导致实际发送到谷歌的还是旧端点。可以临时绕过缓存测试，或者清空相关缓存资源。
• 考虑谷歌通知的延迟性：有时候谷歌的提醒会有延迟，比如你刚完成迁移，之前的调用记录还在系统队列里，所以延迟发送了通知。这种情况可以观察1-2天，如果没有新的提醒，大概率就是延迟导致的。

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