Merchant Products API 版本说明

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 子 API Beta 版