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 年初的最终停用时间。