最新动态

获取有关新功能、问题修复和版本更新的最新公告。

2026 年 8 月

2026 年 8 月

新变化：

  • Content API for Shopping 已于 2026 年 8 月 18 日弃用。所有开发者都必须尽快将其现有集成迁移到 Merchant API。如需了解详情，请参阅弃用和停用。
  • 通用商务协议 (UCP) 账号集成：在账号服务资源中添加了 UcpCheckoutManagement 作为服务类型，并支持 ucp-integration 计划和 ucp_integration 服务条款（访问权限受限）。
  • 商品级退货政策替换：在 ProductAttributes 中添加了 returns 属性，以便直接在商品级别配置和替换退货政策（例如国家/地区、退货期限天数、退货费用、商品使用情况）。
  • 房地产租赁属性：向 ProductAttributes 添加了主要房源属性（包括 leaseTerm），用于提交租赁广告数据。
  • Inventories sub-API 增强功能：
  • 账号服务通知：在 Notifications 子 API 中添加了 ACCOUNT_SERVICE 作为受支持的 NotificationEventType，用于跟踪账号服务的状态变化。如需详细了解账号服务变更通知，请参阅接收账号服务变更推送通知。
  • YouTube 购物联属营销报告数据视图 (v1alpha)：
  • 会员回馈目标客户匹配端点：上传和管理客户忠诚度数据，以便在自然搜索结果中显示会员等级福利（例如会员价）。如需详细了解客户忠诚度数据，请参阅会员回馈目标客户匹配服务概览。
  • Alpha 版客户端库公共代码库：适用于 Python、Java、PHP、C#、Ruby、Node.js 和 Go 的 Reviews 子 API 的 Alpha 版库现已在公共 GitHub 代码库中提供。

具体变化：

  • ListAccounts 访问权限级别过滤条件：引入了 access 参数，该参数支持 DIRECT、INDIRECT 和 ALL，可根据调用方权限过滤账号。这可用于区分高级账号和子账号。
  • DataSources 配额和规则验证：
  • 延迟时间缩短：减少了商品插入、更新和删除调用的 API 开销。

即将推出：

  • Content API for Shopping 弃用和关停：提醒您过渡到新的 Merchant API。为了鼓励开发者在服务完全停用之前完成迁移，并确保开发者在其应用日志中注意到弃用通知，Google 将从 2026 年 9 月 1 日开始逐步降低服务质量。如需了解详情，请参阅 Content API for Shopping 弃用时间表部分。

2026 年 5 月

2026 年 5 月

新变化：

具体变化：

  • Merchant API v1beta 版本已停用。现在，所有 API 调用都必须定向到 v1 或 v1alpha 版本。如需了解迁移步骤，请参阅从 v1beta 迁移到 v1。
  • 现在，您可以通过 Products 子 API 中的 patch 方法，更频繁地在属性级别更新 price 和 availability。此功能可让您以更低的延迟更新这些特定属性，从而提高数据新鲜度。目前，此功能仅面向列入许可清单的商家提供。如需了解详情或申请访问权限，请与您的 Google 代表联系。

即将推出：

  • 在 Reports API 中使用 UCP 分析智能体性能。

2026 年 1 月

2026 年 1 月

新变化：

具体变化：

  • 向本地商品目录服务添加了 InventoryLoyaltyProgram，以便用户能够统一控制会员功能，例如折扣、未来购物返现和会员积分。

即将推出：

  • Merchant API v1beta 将于 2026 年 2 月 28 日停用。在 v1beta 停用截止日期之前，请分别将所有 API 调用定向到 v1 和 v1alpha 版本。
  • 能够通过 Reviews API v1alpha 启用和停用商品评价计划，从而简化商品评价的提交和管理流程。

2025 年 11 月

2025 年 11 月

新变化：

  • YouTube 购物联属营销计划数据分析 (v1alpha) 的新数据分析，在 Reports 子 API 中，用于检索有关 YouTube 上推介的创作者、内容和商品的数据分析。它与 Google Merchant Center (GMC) 中现有的报告功能相当。
  • 升级后的 API 诊断工具，支持迁移到 Merchant API(v1)。
  • 向 Accounts 子 API 添加了新字段 product_filters，以便商家根据对商家商品属性的一些条件过滤，仅与 Google Ads 账号共享其 Feed 的一部分。此功能仅面向部分商家提供。
  • 新增了对电子商务平台上的卖家创建独立账号的支持。
  • 添加了两个新方法：accounts.limits.get 和 accounts.limits.list，用于在 Quota API 中查询账号限制。

具体变化：

  • 现在，所有使用商品 ID 的方法都支持自动检测和内部解码 base64url 编码的商品 ID。

即将推出：

  • YouTube 购物联属营销计划数据分析 (v1alpha) 的新数据分析，在 Reports 子 API 中，用于检索有关 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 子 API 中的新方法 getAccountForGcpRegistration，用于检索已在 Google Cloud 中注册的商家账号。

具体变化：

  • Accounts 子 API 中用于区域管理的新方法。
    • 引入了三种新方法：batchCreate、batchDelete 和 batchUpdate，以便为 Accounts 子 API 中 Regions 的 create、update 和 delete 操作启用调用批处理，从而简化区域管理并缓解 one-region-per-request 调用的限制。
  • Products 子 API 中提供了一种新的基于运输公司的配送配置，用于在商品级别指定配送属性。

即将推出：

  • 新增了 YouTube 购物联属营销计划分析报告，例如 Reports sub-API 中的 v1alpha，用于检索有关 YouTube 上展示的创作者、内容和商品的分析数据，这些报告与 Google Merchant Center 中提供的报告一致。
  • 更频繁地更新库存状况和价格属性。
  • 通过丰富的 ErrorInfo 和元数据，更轻松地分析 API 错误。

2025 年 7 月

2025 年 7 月

新变化：

  • Merchant API (v1) - Content API for Shopping 的官方升级版现已正式发布。

    这意味着，今后 Merchant API 中将只有 v1alpha 和 v1 子 API，大多数 v1beta 版本将升级为 v1。敬请关注更多详情。

  • 有新资源。

    • Product Studio API（Alpha 版）中的图片资源利用生成式 AI 生成新的商品背景、移除图片背景并提升图片分辨率。
    • Accounts 子 API 中的 Checkout on Merchant（在商家网站上结账）可让您创建、更新、删除和获取结账设置。
    • Accounts sub-API 中的在线退货政策已迁移，用户功能保持不变。为了保持一致性，我们移除了过时的字段，并重命名了现有字段，从而实现了细微的技术改进。
    • Accounts 子 API 的 AccountRelationship 资源中的 AccountIdAlias 使用用户定义的别名，而不是内部 ID（账号 ID）。这样可以更轻松地管理复杂的账号结构，例如为您的市场使用用户定义的别名，而不是内部 ID。

  • Apps 脚本用户现在可以使用 Merchant API。

  • 问题解决 API 中现在提供了一个新的 AggregateProductStatuses 方法，用于查询有关商品状态的汇总统计信息。

具体变化：

  • 能够为商店开设平台和 CSS 创建独立账号。以前，商家账号是在单个高级账号下创建的。

  • 点击 Reports sub-API 下 productView 表中的获得点击的潜力排名。现在，系统会将基于 clickPotential 的商品排名归一化为 1 到 1000 之间的值。clickPotentialRank较低的商品在满足搜索查询条件的商家商品中仍具有最高的click potential。

即将推出：

  • 通过 Model Context Protocol (MCP) 服务器 (v1alpha) 访问。

2025 年 5 月

2025 年 5 月

新变化：

  • 我们推出了两个新的 sub-API。
    • 订单跟踪支持商家订单跟踪记录，可为客户提供精确、准确的配送估算。其信号还可用于启用免费快速配送的增强版商品详情。
    • 问题解决提供对诊断内容和支持操作的访问权限，其方式与 Merchant Center 界面中的方式相同。
  • Accounts sub-API 中提供了新资源。
    • OmnichannelSettings 管理全渠道投放的账号配置，例如非付费本地商品详情 (FLL) 和本地商品目录广告 (LIA)。
    • LfpProviders 连接到本地 Feed 合作伙伴计划 (LFP) 合作伙伴，以获取商品目录数据。
    • GbpAccounts 连接到 Google 商家资料账号，以获取本地实体店数据。
    • OnlineReturnPolicy 能够创建、删除和更新在线政策。
  • Products sub-API 中提供了一种新方法。
    • ProductsUpdate 允许您更新单个商品，而无需提供 ProductInput 所需的所有字段。

具体变化：

  • 每次 API 调用的 pageSize 上限从 250 行增加到 1,000 行。
  • 修复了在 DataSources 创建后，商品插入、促销活动、商品评价和商家评价存在延迟的问题。

即将推出：

  • 弃用并将在未来移除 DataSources 和商品的 channel 字段。
  • 在报告子 API 下的 productView 表中发布了 clickPotentialRank 的更新定义：
    • 基于 clickPotential 的商品排名会归一化为 1 到 1000 之间的值。
    • 在符合搜索查询条件的商家商品中，clickPotentialRank较低的商品仍具有最高的获得点击的潜力。这是一项非破坏性更改，可能会在 2025 年 7 月 1 日发布。
  • AccountRelationship 资源中的 AccountIdAlias 可让您更好地管理复杂的账号结构。例如，购物平台会使用用户定义的别名，而不是商家的内部 ID（例如账号 ID）。

2025 年 4 月

2025 年 4 月

新变化：

具体变化：

  • 我们现在支持 Data Sources sub-API 的目标平台（在 Merchant Center 中称为营销方式）。
  • 我们对该资源进行了多项调整，建议您查看账号版本说明，了解更多详情。
  • Products sub-API 中的 taxes 和 tax_category 字段已弃用，这与 Content API 中 accounttax 的弃用一致。

即将推出：

  • 我们已考虑您的反馈，并正在努力改进 API 开发者文档。
  • 请持续关注并更频繁地回来查看，并随时向我们提供更多反馈。
上一页
YouTube Shopping developer policies
下一页
Design