Merchant Products API 版本说明

2026 年 10 月 5 日当周

向 Warranty 属性添加了 duration_unit 字段。

详细了解保修。

2026 年 9 月 8 日当周

在 installment 中添加了 mileage_allowance。

2026 年 9 月 2 日当周

向 Certification 属性添加了 certification_document_link 和 certification_label_link 字段。

详细了解认证。

2026 年 7 月 27 日当周

产品服务

向 ProductAttributes 资源添加了以下与房地产租赁相关的属性：

2026 年 7 月 20 日当周

产品服务

添加了 returns 字段，以启用商品级退货政策替换。借助此字段，您可以直接在商品 Feed 和 API 中指定精细的退货规则（例如国家/地区、退货期限天数、商品使用情况、退货方式、退货结果、费用和政策网址）。

2026 年 6 月 15 日当周

产品服务

向 ProductAttributes 资源添加了以下与房地产租赁相关的属性：

这些属性仅面向参与封闭式 Beta 版测试的商家提供。如果您有兴趣参与，请与您的 Google 销售代表联系。

2026 年 5 月 18 日当周

产品服务

向 ProductAttributes 资源添加了以下对话属性：

这些属性尚未在客户端库中提供，很快就会推出。在此期间，您可以使用自定义属性来指定这些信息。

2026 年 5 月 11 日当周

产品服务

向 Product 资源添加了 archived 字段，用于指明商品是否已归档。详细了解优惠可见性。

2026 年 4 月 27 日当周

在 installment 中添加了 total_amount。

产品服务

向 ProductAttributes 资源添加了以下与车辆相关的属性：

2026 年 4 月 13 日当周

在配送属性中添加了 loyalty_program_label 和 loyalty_tier_label 字段，以便为特定会员回馈活动和层级配置配送选项。

添加了 minimum_order_values 字段，用于指定用户在发起结账之前购物车中所需的最低订单金额。

在 installment 中添加了“annual_percentage_rate”。

产品服务

添加了 video_links 字段。您可以通过此字段提供商品的视频网址。

2026 年 4 月 6 日当周

向 Product 和 ProductInput proto 消息添加了 base64_encoded_name 字段，以便在名称包含特殊字符的情况下直接使用输出名称作为输入。

2026 年 3 月 16 日当周

产品服务

添加了 return_policy_label 字段。

2025 年 12 月 1 日当周

在 period 中添加了“WEEK”作为可能的订阅期。

2025 年 11 月 17 日当周

除了未编码/纯文本值之外，请求路径中的商品标识符现在还支持未填充的 base64url 编码。这项增强功能可确保系统能够成功检索和处理标识符中包含特殊字符（例如正斜杠）的商品。

2025 年 11 月 3 日当周

产品服务

添加了 shipping_handling_business_days 和 shipping_transit_business_days 字段，以便指定在计算送货时长时应考虑一周中的哪些天。

2025 年 9 月 29 日当周

产品服务

添加了 carrier_shipping 字段，以便使用运输公司指定运费和配送速度的配送配置。

2025 年 7 月 7 日当周

产品服务

添加了 GTIN 字段的复数版本，并弃用了单数版本。 目前，在读取时，系统会同时填充这两个字段，并且在插入时，系统会同时使用这两个字段中的值。

2025 年 6 月 16 日当周

产品服务

添加了 maximum_retail_price 字段，以便在印度指定最高零售价 (MRP)。

2025 年 5 月 19 日当周

产品服务

将页面大小的最大值从 250 增加到 1000。

2025 年 5 月 12 日当周

ProductInputs 服务

缩短了数据源创建到数据源可供使用之间的延迟时间。以前，在数据源创建后 5 分钟内尝试插入内容时，系统会返回 Data source not found 错误。这适用于插入商品、促销活动、商品评价和商家评价的数据源。

2025 年 4 月 14 日当周

由于 Content API 中的 accounttax 已弃用，Product 资源中的 taxes 和 tax_category 字段也已弃用。

2025 年 4 月 3 日当周

产品服务

发布 automated_discounts 字段。自动折扣旨在动态调整产品价格折扣，帮助您有效实现整个商品目录的毛利润最大化。

automated_discounts 字段包含有关原价、连续降价前的价格以及自动折扣价格的信息。

2025 年 3 月 24 日当周

ProductInputs 服务

发布了 accounts.productInputs.patch 方法，让您可以通过更新掩码更新单个商品输入，而无需提供 accounts.productInputs 资源的所有字段。

2025 年 1 月 6 日当周

返回的错误中的 domain 字段现在填充的是 merchantapi.googleapis.com，而不是 global

2024 年 12 月 12 日当周

产品服务

添加了 sustainability_incentives 字段，用于为您的商品指定可持续发展激励措施，例如税收抵免或价格折扣。如果未提供字段值，则商品不符合任何可持续发展激励措施的条件。

2024 年 11 月 15 日当周

产品服务

对于 LoyaltyProgram，添加了 shipping_label 字段以指定资格条件。如果该字段有值，则表示此优惠包含会员配送福利。如果未提供字段值，则商品不符合指定会员层级的会员配送条件。

2024 年 7 月 15 日当周

产品服务

添加了 member_price_effective_date 字段。通过此次更新，您可以指定会员价的有效日期范围（如果适用）。如果未提供字段值，则会员价始终有效。

2024 年 5 月 27 日当周

Products sub-API 的 Beta 版发布