获取有关新功能、bug 修复和版本更新的最新公告。
2026 年 1 月
2026 年 1 月
新变化:
在 Reports sub-API 中新增了报告上下文值,用于了解 UCP(通用商务协议)结账的商品资格状态。
FREE_LISTINGS_UCP_CHECKOUT在 Reports sub-API 中引入了 YouTube 购物联属营销计划效果报告 ( v1alpha)。
新增了对
ErrorInfo消息的支持,以便为错误的 API 调用提供机器可读的元数据。同时还新增了 错误处理指南 和 错误消息完整列表。
具体变化:
- 在本地商品目录服务中添加了
InventoryLoyaltyProgram,以便用户能够统一控制 忠诚度功能,例如折扣、未来购买的返现和忠诚度 积分。
即将推出:
- Merchant API v1beta 将于 2026 年 2 月 28 日停用 。请在 v1beta 停用截止日期之前,将所有 API 调用分别定向到 v1 和 v1alpha 版本。
- 能够通过 Reviews API v1alpha 启用和停用商品评价计划,从而简化商品评价的提交和管理流程。
2025 年 11 月
2025 年 11 月
新变化:
- 在 Reports sub-API 中新增了 YouTube 购物联属营销计划分析 (v1alpha) 的数据分析,用于检索有关创作者、 内容和 YouTube 上推荐的商品的数据分析。它与 Google Merchant Center (GMC) 中提供的现有 报告对等。
- 升级了 API 诊断工具 以支持迁移到 Merchant API(v1)。
- 在 Accounts sub-API 中添加了新字段
product_filters, 以便商家能够根据商家商品属性的一些条件过滤器,仅与 Google Ads 账号共享部分 Feed。此功能仅供少数商家使用。 - 新增了对在电子商务平台上为卖家创建独立账号的支持。
- 添加了两个新方法
accounts.limits.get和accounts.limits.list,用于在 Quota API 中查询账号限制。
具体变化:
- 现在,在使用商品 ID 的所有方法中,都支持自动检测和内部解码 base64url 编码的商品 ID。
即将推出:
在 Reports sub-API 中新增了 YouTube 购物联属营销计划分析 (v1alpha) 的数据分析,用于检索有关创作者、 内容和 YouTube 上推荐的商品的数据分析。它与 Google Merchant Center (GMC) 中提供的现有 报告对等。
Merchant API 中的 v1beta 版本将于 2026 年 2 月 28 日停用。所有 API 调用都必须在 v1beta 停用截止日期之前分别定向到 v1 和 v1alpha 版本。如需了解详情,请参阅 Merchant API 版本控制和停用政策。
2025 年 9 月
2025 年 9 月
新变化:
- Merchant API 的第一个 Model Context Protocol (MCP) 服务
现已推出。
- 新的 MCP 服务将权威的 Google API 文档集成到集成开发环境 (IDE) 编码助理中,以加快 Merchant API 集成并提高迁移工作流的准确性。
- 在 Accounts sub-API 中新增了方法
getAccountForGcpRegistration,用于检索已注册 Google Cloud 的商家账号。
具体变化:
- 在 Accounts sub-API 中
新增了用于管理区域的方法。
- 引入了三个新方法
batchCreate、batchDelete和batchUpdate,以便为 Accounts sub-API 中的区域的create、update和delete操作启用调用批处理,从而简化区域管理并缓解one-region-per-request调用的限制。
- 引入了三个新方法
- 在 Products sub-API 中新增了基于运营商的配送配置,用于在商品级别指定配送属性。
即将推出:
- 新增了 YouTube 购物联属营销计划分析报告,例如 Reports sub-API 中的 v1alpha,用于检索有关创作者、内容和 YouTube 上推荐的商品的数据分析,这些报告与 Google Merchant Center 中提供的报告对等。
- 能够更频繁地更新库存状况和价格属性。
- 能够更轻松地分析 API 错误,因为 ErrorInfo 和元数据更加丰富。
2025 年 7 月
2025 年 7 月
新变化:
Merchant API (v1) - Content API for Shopping 的正式升级版现已正式发布。
这意味着,今后 Merchant API 中将仅包含 v1alpha 和 v1 sub-API,大多数 v1beta 版本将升级到 v1。更多信息即将发布,敬请关注。
新增了资源。
- Product Studio API (alpha) 中的图片资源 利用生成式 AI 生成新的商品 背景、移除图片背景并提升图片分辨率。
- Accounts sub-API 中的“Checkout on Merchant”能够创建、更新、删除和获取 结账设置。
- Accounts sub-API 中的“Online Return Policy”已迁移,用户功能 保持不变。为了保持一致性,我们移除了一些技术改进,例如过时的字段和重命名字段。
- Accounts sub-API 中 AccountRelationship资源中的
AccountIdAlias使用用户定义的别名,而不是 内部 ID(账号 ID)。这样可以更轻松地管理复杂的账号结构,例如为您的购物平台使用用户定义的别名,而不是内部 ID。
Apps 脚本 用户 现在可以使用 Merchant API。
Issue resolution API 中新增了
AggregateProductStatuses方法,用于查询有关商品状态的合并 统计信息。
具体变化:
- 能够为 storebuilder 和 CSS 创建独立账号。以前,商家账号是在单个多客户账号 (MCA) 下创建的。
点击 Reports sub-API 下
productView表中的获得点击的潜力排名。现在,根据clickPotential对商品进行排名时,排名会归一化为 1 到 1000 之间的值。 在满足搜索查询条件的商家商品中,clickPotentialRank较低的商品仍然具有最高的click potential。
即将推出:
- 能够通过 Model Context Protocol (MCP) 服务器 (v1alpha) 进行访问。
2025 年 5 月
2025 年 5 月
新变化:
- 我们推出了两个新的 sub-API。
- Accounts sub-API 中新增了资源。
OmnichannelSettings用于管理全渠道投放的账号配置,例如免费本地商品详情 (FLL) 和本地商品目录广告 (LIA)。LfpProviders用于连接到本地 Feed 合作伙伴计划 (LFP) 合作伙伴以获取商品目录数据。GbpAccounts用于连接到 Google 商家资料账号以获取本地实体店数据。OnlineReturnPolicy用于创建、删除和更新在线政策。
- Products sub-API 中新增了方法。
ProductsUpdate可让您更新单个商品,而无需提供ProductInput所需的所有字段。
具体变化:
- 每次 API 调用可处理的最大行数从 250 行增加到 1000 行。
pageSize - 修复了在创建
DataSources后,商品插入、促销、商品评价和 商家评价存在的延迟问题。
即将推出:
- 将弃用并移除
DataSources和商品的渠道字段。 - 在 Reports sub-API 下的
productView表中推出了clickPotentialRank的更新定义:- 根据
clickPotential对商品进行排名时,排名会归一化为 1 到 1000 之间的值。 - 在满足搜索查询条件的商家商品中,
clickPotentialRank较低的商品仍然具有最高的获得点击的潜力。这是一项非重大变更,可能会在 2025 年 7 月 1 日推出。
- 根据
AccountIdAlias在AccountRelationship资源中,可让您更好地管理复杂的账号结构。例如,购物平台使用用户定义的别名,而不是商家的内部 ID(例如账号 ID)。
2025 年 4 月
2025 年 4 月
新变化:
- 我们推出了一个新的 sub-API。
- Product Studio (ALPHA) 利用生成式 AI 生成和优化商品名和商品描述。 您需要签署此表单才能 申请访问权限。
- Accounts sub-API 中新增了资源。
AutomaticImprovements用于管理 Google Merchant Center 平台提供的三项自动更新功能的启用状态:AccountService和AccountRelationship资源用于管理关系并为服务提供商建立服务。
- 我们在 Products sub-API 中为
AutomatedDiscounts推出了三个字段,用于检索已启用 Google 自动折扣 (GAD) 的商品的实时价格。
具体变化:
- 我们现在支持 Data Sources sub-API 的目标平台,在 Merchant Center 中称为营销方法。
- 我们对资源进行了多项调整,建议您查看 Accounts 版本说明 了解详情。
- Products sub-API 中的字段
taxes和tax_category已弃用,与 Content API 中的accounttax弃用保持一致。
即将推出:
- 我们已考虑您的反馈,并正在努力改进 API 开发者文档的多个方面。
- 请密切关注并更频繁地回来查看,欢迎随时向我们提供更多反馈。 欢迎随时向我们提供更多反馈。