Merchant Products API 版本说明
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
2025 年 7 月 7 日当周
产品服务
添加了 GTIN 字段的复数版本，并弃用了单数版本。
目前，在读取时，这两个字段都会填充，而在插入时，系统会使用这两个字段中的值。
2025 年 6 月 16 日当周
产品服务
添加了 maximum_retail_price 字段，以便在印度指定最高零售价 (MRP)。
2025 年 5 月 19 日当周
产品服务
将页面大小的最大值从 250 增加到 1000。
2025 年 5 月 12 日当周
缩短了数据源创建与数据源可供使用之间的延迟。之前，如果尝试在数据源创建后的 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 日当周
发布了 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 版
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-05。
[null,null,["最后更新时间 (UTC)：2025-08-05。"],[[["\u003cp\u003eThe \u003ccode\u003eshipping_label\u003c/code\u003e field was added to \u003ccode\u003eLoyaltyProgram\u003c/code\u003e to indicate eligibility for loyalty shipping benefits, determined by whether the field has a value.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003emember_price_effective_date\u003c/code\u003e field enables merchants to define the effective date range for loyalty member pricing, with continuous effectiveness if the field is left empty.\u003c/p\u003e\n"],["\u003cp\u003eThe Products sub-API was launched in beta during the week of May 27, 2024.\u003c/p\u003e\n"]]],[],null,["# Merchant Products API release notes\n\nWeek of July 7, 2025\n--------------------\n\n### Products Service\n\nAdded a plural version of GTINs field and deprecated a singular one.\nFor now both fields will be populated when reading and values from both fields\nwill be used during insertion.\n\nWeek of June 16, 2025\n---------------------\n\n### Products Service\n\nAdded the [`maximum_retail_price`](/merchant/api/reference/rest/products_v1beta/Attributes#FIELDS.maximum_retail_price) field to enable the specification of maximum retail price (MRP) in India.\n\nWeek of May 19, 2025\n--------------------\n\n### Products Service\n\nIncreased the maximum value of page size from 250 to 1000.\n\nWeek of May 12, 2025\n--------------------\n\n### ProductInputs Service\n\nReduced the delay between data source creation and when the data source is ready\nto be used. Previously, the `Data source not found` error was returned when\ntrying to insert items within 5 minutes of the data source being created. This\napplies to data sources used for inserting products, promotions, product\nreviews, and merchant reviews.\n\nWeek of Apr 14, 2025\n--------------------\n\nThe fields `taxes` and `tax_category` in the `Product` resource have been\ndeprecated due to the deprecation of `accounttax` in the Content API.\n\nWeek of Apr 03, 2025\n--------------------\n\n### Products Service\n\nLaunch of the\n[`automated_discounts`](/merchant/api/reference/rest/products_v1beta/accounts.products#AutomatedDiscounts)\nfield. Automated discounts are designed to dynamically adjust product price\ndiscounts such that they help you effectively maximize gross profit performance\nacross your entire inventory.\n\nThe `automated_discounts` field contains information about the prior prices,\nprice prior to the application of consecutive price reductions, and the\nAutomated Discount price.\n\nWeek of Mar 24, 2025\n--------------------\n\n### ProductInputs Service\n\nLaunch\nof [`accounts.productInputs.patch`](/merchant/api/reference/rest/products_v1beta/accounts.productInputs/patch)\nmethod that lets you update individual product inputs through update mask and\nwithout providing all the fields of the `accounts.productInputs` resource.\n\nWeek of Jan 6, 2025\n-------------------\n\nThe `domain` field in returned errors is now populated with\n`merchantapi.googleapis.com` instead of `global`\n\nWeek of Dec 12, 2024\n--------------------\n\n### Products Service\n\nAdded\nthe [`sustainability_incentives`](/merchant/api/reference/rest/products_v1beta/Attributes#FIELDS.sustainability_incentives)\nfield to specify sustainability incentives such as tax credit or price discount\nfor your products. If the field value isn't provided, the item is not eligible\nfor any sustainability incentives.\n\nWeek of Nov 15, 2024\n--------------------\n\n### Products Service\n\nFor `LoyaltyProgram`, added\nthe [`shipping_label`](/merchant/api/reference/rest/products_v1beta/Attributes#FIELDS.shipping_label)\nfield to specify eligibility. If the field has value, this offer has loyalty\nshipping benefit. If the field value isn't provided, the item is not eligible\nfor loyalty shipping for the given loyalty tier.\n\nWeek of July 15, 2024\n---------------------\n\n### Products Service\n\nAdded\nthe [`member_price_effective_date`](/merchant/api/reference/rest/products_v1beta/Attributes#LoyaltyProgram.FIELDS.member_price_effective_date)\nfield. This update lets you specify, if applicable, the date range during which\nthe loyalty\nmember price is effective. If the field value isn't provided, the member price\nis always\neffective.\n\nWeek of May 27, 2024\n--------------------\n\nBeta launch of Products sub-API"]]
