关于Google API相关端点迁移（截止2019年3月25日）的技术问询

首先确认你收到的是Google当年针对旧API端点的官方变更通知，我来帮你梳理迁移的核心要点和常见问题：

昨日我收到Google开发团队的邮件通知：我们特此告知，JSON-RPC和Global HTTP batch端点将于2018年3月26日被弃用，并自2019年3月25日起停止服务。通知要求请在2019年3月25日前完成以下受影响项目的应用迁移工作；团队表示知晓这些变更会对客户产生影响，已尽力使迁移步骤尽可能清晰。

迁移核心方向与实操步骤 #

• 替换JSON-RPC接口：Google所有提供JSON-RPC的服务，基本都有功能对等的REST API替代方案。你需要把原有JSON-RPC请求（通常是POST携带method、params等字段）转换为标准REST请求——比如用GET获取资源、POST创建资源，严格按照目标服务的REST文档构造参数、解析响应结构。
• 替代Global HTTP Batch：全局batch端点停用后，需改用各服务专属的batch接口（比如Gmail的https://www.googleapis.com/batch/gmail/v1）。注意不同服务的batch请求格式存在差异：有的要求每个子请求带Content-ID，有的限制单批次最多包含100个请求。如果业务对批量处理性能要求高，也可以考虑用异步任务队列拆分大批次请求，避免单次请求超时。
• 全量兼容性验证：迁移后务必在测试环境跑通所有业务流程，重点检查：
  • 参数映射是否准确（比如JSON-RPC的方法名对应REST的哪个端点路径）
  • 响应解析逻辑是否适配REST的返回结构（比如原JSON-RPC的result字段可能变为REST响应的顶层数据）
  • 错误处理机制是否兼容新接口的状态码体系（REST常用4xx/5xx状态码，和JSON-RPC的错误码逻辑不同）

常见坑点与解决思路 #

• 若原有JSON-RPC功能在REST中找不到直接对应，先查看服务的API变更日志——Google常会把旧功能拆分为多个REST接口，或提供新的参数组合实现等效功能；
• 授权问题：确保OAuth2令牌的权限范围包含新REST接口的要求，部分场景下原JSON-RPC使用的scope和REST接口不兼容，需更新授权流程；
• 性能下降：替换batch后若请求变慢，可尝试调整批次大小，或启用HTTP/2复用连接提升效率。

要是你有具体场景细节（比如用到了哪个Google服务的接口、现有代码中的关键逻辑），可以补充出来，我会给你更针对性的解决方案。

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