Merchant Products 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 版