Merchant Products API 版本说明

2026 年 4 月 13 日当周

向“运费”属性添加了 loyalty_program_labelloyalty_tier_label 字段,以便为特定的会员回馈活动和会员等级配置配送选项。

添加了 minimum_order_values 字段,用于指定购物车中必须达到的最低订单价值,用户才能开始结账。

installment 中添加了“annual_percentage_rate”。

产品服务

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

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 版