Google Content API for Shopping 已于 2026 年 8 月 18 日 正式弃用。 所有开发者都必须尽快将现有集成迁移到 Merchant API。
为了鼓励开发者在全面停用之前进行迁移，并确保开发者在其应用日志中留意弃用通知，Google 将于 2026 年 9 月 1 日 开始逐步降低服务质量。
弃用时间表
下表概述了 Google Content API for Shopping (v2.1) 的服务质量降低和最终停用时间表：
| 日期 | 里程碑 | 详细信息 |
|---|---|---|
| 2026 年 9 月 1 日 | 开始间歇性地出现请求失败的情况 | 没有有效延期的请求开始间歇性地失败，并显示 HTTP 410 Gone。 |
| 2027 年初 | 停用 | 全面关停。所有端点都将关闭，所有请求都会失败。 |
服务质量降低和错误响应
自 2026 年 9 月 1 日起，没有有效延期的客户端向 Google Content API for Shopping 端点发送的请求将间歇性地失败，并显示 HTTP 410 Gone 状态代码。
错误响应格式
当请求因计划的服务降级而被拒绝时，API 会返回 HTTP 410 Gone 错误载荷，其中包含消息和元数据以及您的 Google Cloud 云项目详细信息：
{
"error": {
"code": 410,
"message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
"status": "ABORTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "content_api_sunset",
"domain": "shoppingcontent.googleapis.com",
"metadata": {
"GCP_ID": "YOUR_PROJECT_ID",
"GCP_NUMBER": "YOUR_PROJECT_NUMBER",
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
}
}
]
}
}
错误响应包含以下元数据字段：
GCP_ID：发出请求的 Google Cloud 项目的 ID。GCP_NUMBER：Google Cloud 项目的唯一数字标识符。HELP_CENTER_LINK：指向迁移文档的直接链接。
配额影响
在服务质量降低期间生成的人为错误响应不会计入项目的 API 配额。
重试失败的请求
由于初始服务质量降低只会导致部分请求失败，因此重试失败的请求可能会成功。不过，依赖重试并不是可行的长期解决方案，因为失败的请求会越来越频繁，直到停用时所有请求都失败。
受影响的开发者
弃用和服务质量降低流程对开发者和企业的影响如下：
- 自定义 API 集成： 如果您的组织维护着直接调用 Google Content API for Shopping 的内部工具、脚本或自定义软件，则必须更新应用以调用 Merchant API。
- 第三方平台： 如果您通过电子商务平台访问 Merchant Center，则您的平台合作伙伴会代表您管理迁移。您无需采取任何措施。
需要采取行动
为防止商品详情和账号管理中断，请执行以下操作：
- 查看 Merchant API 概览 ，了解架构、身份验证和子 API 结构。
- 按照 从 Content API for Shopping 迁移到 Merchant API 指南中的说明，为当前的 Content API 服务找到现代替代方案。
- 为您的编程语言安装最新的 Merchant API 客户端库 。
- 在部署到生产环境之前，先在开发环境中更新和测试集成。
申请延期
如果您的组织需要更多时间来完成迁移，您可以申请延期，以便暂时免受 Google Cloud 项目的服务质量降低错误的影响。如需申请延期，请提交 Content API 延期申请表单。
获批的延期会在获批的延期期限内保护您的项目免受计划的错误响应的影响。延期不会超过 2027 年初的最终停用时间。