Merchant Products API 版本说明

2026 年 4 月 6 日当周

ProductProductInput 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_daysshipping_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 资源中的 taxestax_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 版