Google Content API 已停用：Merchant API 迁移怎么验收？

店铺运营工具 2026-08-24 09:50 出海推荐编辑部 8 views

Google Merchant API 迁移验收清单：确认技术提供方、开发者注册、资源名称、商品写入、数据源、诊断、配额与回滚。

Google Content API 已停用：Merchant API 迁移怎么验收？

先说结论：Google 已将 2026 年 8 月 18 日设为 Content API for Shopping 停用时间。 自建商品同步、ERP 或代理商集成不能只把接口域名替换为 Merchant API，还要重新核对开发者注册、资源名称、字段映射、批处理方式、诊断结果和生产监控；使用 Shopify Google & YouTube 等第三方技术提供方的商家，则应先确认是否由提供方完成迁移。

第一步先判断谁负责迁移

把 Merchant Center 商品写入链路画出来：店铺或 ERP、连接应用、Google Cloud 项目、Merchant Center 账号、数据源和目标国家。Google 官方迁移指南说明，使用第三方技术合作伙伴同步商品时，通常由提供方处理 API 迁移；自建集成才需要团队直接改造。

不要凭应用名称判断。应检查最近一次成功写入时间、调用日志中的接口主机、依赖库版本和服务商公告，确认当前生产流量是否已经离开旧 Content API。

Merchant API 不是一比一替换

Google 官方文档列出的关键变化包括：

请求转向 merchantapi.googleapis.com 下的不同子 API；
资源使用包含父级路径的 name 标识，不再沿用旧 ID 拼接方式；
子资源通过 parent 指向上级资源；
customBatch 不再支持，需要改为并行或异步调用；
商品、数据源、账号、报告和问题解决能力分布在不同子 API；
开发者需要把 Google Cloud 项目与主要 Merchant Center 账号完成注册关联。

因此迁移清单应按实际调用方法逐项映射，而不是只验证一次 token 或单个商品上传。

用四条用户旅程验收

新增商品：写入一个测试 SKU，核对语言、国家、价格、库存、链接和图片。
更新与删除：修改价格或库存，确认 Merchant Center 状态与预期一致，再测试删除或失效流程。
数据源与诊断：检查账号问题、商品问题、严重级别和处理建议是否仍能读到。
批量与异常：验证并发、限流、重试、幂等和部分失败，确保单条错误不会重复覆盖整批商品。

上线前保留旧链路的最后成功时间、商品数量和错误率作为对照。Google 官方建议按子 API 或小流量分阶段迁移，并持续监控。

迁移后的商品展示问题，可继续使用站内Google Merchant Center Needs attention 诊断流程排查；若页面本身抓取异常，使用Search Console 索引排错流程区分商品 Feed 与网页索引问题。

迁移完成的最小证据

至少保存开发者注册成功、生产调用使用 Merchant API、核心用户旅程通过、商品数量差异在预期内、错误率稳定、限流与重试正常、旧 Content API 调用为零，以及明确的回滚和责任人。只看到 Merchant Center 前台有商品，不足以证明自动同步链路完整。

常见问题

Shopify 商家一定不用处理吗？

使用 Google 明确提到的第三方技术提供方时，迁移通常由提供方完成，但商家仍应核对应用公告、最近同步和商品诊断，不能把“无需改代码”理解为“无需验收”。

新旧 API 可以长期混用吗？

Google 的兼容说明允许迁移阶段按子 API 推进，但已迁移能力建议只使用 Merchant API；旧 Content API 已到停用节点，不应继续作为长期生产依赖。

只测试一个商品够吗？

不够。还要覆盖更新、删除、诊断、批量、限流、错误重试和数据源，尤其要验证失败不会造成库存或价格回滚。

核验来源

本文依据 2026 年 8 月 24 日可访问的 Google 官方文档整理，不代表对某个第三方应用迁移状态的确认。