Merchant Product API 版本資訊
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
2025 年 7 月 7 日當週
產品服務
新增全球交易品項識別碼欄位的複數版本，並淘汰單數版本。目前讀取時會填入這兩個欄位，插入時則會使用這兩個欄位的值。
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 版發布
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-05 (世界標準時間)。
[null,null,["上次更新時間：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"]]
