获取有关新功能、bug 修复和版本更新的最新公告。
2026 年 5 月
2026 年 5 月
新变化:
- 我们推出了新的 Merchant API MCP 服务 (Alpha 版),该服务可授权访问您的 Merchant Center 数据和分析 并专注于只读,是 Merchant API 的新智能体工具。
新的对话属性 现在可以在 Products sub-API 的
ProductAttributes下找到。这些属性包括:
我们在 Products sub-API 中添加了一整套专门用于车辆广告的属性。
现在,您可以通过报告上下文值
FREE_LISTINGS_UCP_CHECKOUT在 Notifications API 中获取有关 通用商务协议 (UCP) 结账 的商品状态变更通知。Merchant API Agent Skills 是 Code Assist Toolkit 中的新智能体工具。 新的
mapi-developer-assistant技能基于开放的 Agent Skills 标准构建,可提供智能且情境化的帮助。它将特定领域的专业知识、自动化工作流和更高的效率引入 Antigravity CLI 和 IDE 等 AI 工具中,以加快集成速度。我们推出了新的 YouTube sub-API v1alpha 版本,用于管理 YouTube 联属营销计划合同。
我们在 Accounts sub-API 中添加了对管理 YouTube 购物联属营销计划和商品评价 计划 的支持。
我们推出了新的数据源,用于在高级账号级别进行商品促销。
具体变化:
- Merchant API v1beta 版本已停用。现在,所有 API 调用都必须定向到
v1或v1alpha版本。如需了解迁移步骤,请参阅从 v1beta 迁移到 v1。 - 现在,您可以通过 Products sub-API 中的
patch方法更频繁地更新price和availability属性。借助此功能,您可以以更低的延迟更新这些特定属性,从而提高数据新鲜度。目前,此功能仅面向已列入许可名单的商家提供。如需了解详情或申请访问权限,请与您的 Google 代表联系。
即将推出:
- Reports API 中提供有关使用 UCP 的智能体效果的数据分析。
2026 年 1 月
2026 年 1 月
新变化:
我们推出了新的报告上下文 值
FREE_LISTINGS_UCP_CHECKOUT,以便了解 UCP(通用商务协议)结账的商品资格状态 在 Reports sub-API 中。我们在 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 日停用。请在 v1beta 停用截止日期之前,将所有 API 调用分别定向到 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”已迁移,用户功能 保持不变。我们进行了一些技术改进,例如移除了过时的字段并重命名了现有字段,以保持一致性。
AccountIdAlias在 Accounts sub-API 中 AccountRelationship 资源中使用的用户定义的别名,而不是 您的内部 ID(账号 ID)。这样可以更轻松地管理复杂的账号结构,例如为您的购物平台使用用户定义的别名,而不是您的内部 ID。
Apps 脚本 用户 现在可以使用 Merchant API。
我们现在在 Issue resolution API 中推出了新的
AggregateProductStatuses方法,用于查询有关商品状态的合并 统计信息。
具体变化:
- 能够为 storebuilder 和 CSS 创建独立账号。以前,商家账号是在单个高级账号下创建的。
点击 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) 的商品的实时价格。
具体变化:
- 我们现在支持目标平台,在 Merchant Center 中称为 Data Sources sub-API 的营销方法。
- 我们对资源进行了多项调整,建议您查看 Accounts 版本说明 了解详情。
- Products sub-API 中的字段
taxes和tax_category已弃用,与 Content API 中accounttax的弃用保持一致。
即将推出: