Content API迁移现在应进入执行阶段。2026年8月18日是正式弃用节点，并非当天全部请求失效。使用自建脚本的团队要尽快切到Merchant API；店铺只接平台商品插件的，先辨认迁移责任人，避免另外建一条重复上传链路。

停用到底分哪三个阶段？

截至9月15日，Google停用说明给出的安排如下。用它判断排期，别沿用“8月全部关闭”的旧说法。

时间服务状态团队此时该做什么
2026年8月18日正式弃用自建项目进入迁移
2026年9月1日起无有效延期的请求间歇返回HTTP 410 Gone查旧调用并推进切换
暂定2027年初所有端点完全关停不再依赖旧接口回退

官方保留调整最终时间的可能。仍有成功请求不能证明集成安全；可申请的延期也只是暂时免除计划降级，不是无限保留旧接口。排期紧张时，由维护该Google Cloud项目的人处理延期，同时继续迁移。

卖家、插件商和开发者各负责什么？

迁移总览明确：通过第三方合作伙伴同步商品的商家，例如Shopify的Google & YouTube应用用户，由提供商处理迁移。

但一个店铺可能有两条同步链：插件每天传商品，外包脚本每小时改库存。前者由插件商负责，不意味着后者也会自动升级。让运营列出商品、库存、促销、报告四类任务，技术人员补上调用方与项目负责人。无需自己改代码的卖家，可以把这张清单交给服务商确认覆盖范围。

多市场店铺还要记录商品所属市场，价格差异可对照Shopify Markets目录定价。迁移时先维持现有业务规则，别把接口切换与改价同时上线。

按五步完成切换

下面是面向团队的执行顺序，不要求运营人员复制API请求。

  1. 盘点调用。 开发者从任务配置和请求日志列出旧接口使用处，运营补齐对应商品范围。周运行的报告任务也要列入，不能只查当天日志。
  2. 注册开发者。 按直接调用快速入门调用注册方法，关联Google Cloud项目与Merchant Center账号。成功后应取得开发者注册资源；若联系人收到邀请，还要接受。API开发者角色主要承担技术通知，操作权限需另外配置。
  3. 确定数据源。 选择沿用旧来源或新建来源，保存每个商品对应的数据源资源名称。不要因为切换域名就顺手删除现有来源。
  4. 验证样本。 在开发环境覆盖商品提交、变价、库存更新及停卖。保留同一商品的offerId、语言与Feed标签，按新格式生成资源名称；核对处理后的商品结果，再扩大范围。
  5. 分批切生产。 停用这一批对应的旧写入任务，再启用新任务。覆盖完整调度周期，确认无遗漏旧调用，并由运营核对商品结果。

样本有偏差时，暂缓扩大这一批，检查属性映射或来源规则。不要让运营在后台逐件修正来掩盖程序问题，否则下一轮自动同步可能再次写入同样的错误。修好映射后重新提交该样本，确认处理结果一致再继续。

迁移工单可按“某市场商品同步已切换、库存任务待切换”写进度。单写“API已升级”，无法说明哪些业务仍会遇到降级。

数据源还叫Content API，算失败吗？

不算。数据源迁移文档允许保留兼容的旧数据源；即使商品已经由Merchant API写入，界面仍可能显示Content API来源。判断依据应是请求去向与商品归属，不能只看名称。

若旧来源和现有规则正好适用，沿用可减少本次变更。旧主来源只接收创建时的语言与Feed标签组合，要增加组合时另行规划来源。要合并来源或增加市场，再考虑新建。新来源可能涉及规则迁移，而规则迁移不能通过API完成，要在Merchant Center界面处理。

例如，英文美国商品原有专门的品牌补全规则。技术人员新建“全球商品”来源后，若只搬商品没搬规则，上传成功也可能缺品牌。这是示例，不是本文测试结果。迁移表因此要多留一列“依赖规则”，由了解Feed配置的人确认。

怎样判断商品真的接好了？

Merchant API把提交内容放在ProductInput，处理结果放在只读Product；状态也随处理后的商品读取。所有商品输入写入需指定数据源，同商品应保持原offerId。具体映射见商品迁移说明。

准备一组示例验收样本：正常商品、促销商品、缺货商品、颜色尺码变体各一件。分别对照源系统与处理结果中的价格、币种、库存和链接。变体关系可配合Merchant Center商品分组核对。刻意选有差异的商品，比随机抽四件正常商品更容易发现映射遗漏。

价格也要核对单位。迁移总览的Price说明指出，新金额字段amountMicros用百万分之一货币单位计数。例如19.99美元对应19990000，币种放在currencyCode。这只是换算示例；把旧金额字符串直接搬过来，不是完成字段迁移。读取Product时还要核对productStatus中的问题与目标状态，不能只检查HTTP成功码。

再让定时任务完成一次真实更新周期。前一次提交正确、后一次被旧程序改回，仍不算完成。接口迁移也不会替代商品审核；后续展示问题可从跨境广告栏目继续查商品资料与投放要求。

本文依据官方接口文档安排迁移，未连接商家生产账号，也未验证具体插件版本。上线负责人应保留切换前的商品与规则配置；退回旧程序前，必须考虑它已经处于降级阶段，不能把旧接口当可靠的长期备用。