Merchant Product API 版本資訊

2026 年 10 月 5 日當週

在 Warranty 屬性中加入 duration_unit 欄位。

進一步瞭解保固。

2026 年 9 月 8 日當週

在 installment 中新增 mileage_allowance。

2026 年 9 月 2 日當週

在 Certification 屬性中新增 certification_document_link 和 certification_label_link 欄位。

進一步瞭解認證。

2026 年 7 月 27 日當週

產品服務

在 ProductAttributes 資源中新增下列房地產租賃相關屬性：

2026 年 7 月 20 日當週

產品服務

新增 returns 欄位，用於啟用商品層級退貨政策覆寫。你可以直接在產品動態饋給和 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 日當週

要求路徑中的產品 ID 現在除了支援未編碼/純值外，也支援未填補的 base64url 編碼。這項強化功能可確保系統能成功擷取及處理 ID 含有特殊字元 (例如正斜線) 的產品。

2025 年 11 月 3 日當週

產品服務

新增 shipping_handling_business_days 和 shipping_transit_business_days 欄位，以便指定計算運送時間時應考量的星期幾。

2025 年 9 月 29 日當週

產品服務

新增 carrier_shipping 欄位，可指定運送設定，使用貨運公司計算運費和運送速度。

2025 年 7 月 7 日當週

產品服務

新增複數版本的全球交易品項識別碼欄位，並淘汰單數版本。目前，讀取時會填入這兩個欄位，插入時則會使用這兩個欄位的值。

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 版