Merchant Product API 版本資訊

2026 年 6 月 15 日當週

產品服務

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

這些屬性僅適用於參與封閉測試版的商家。如有意使用這項功能，請與您的 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 日當週

推出 Beta 版 Products 子 API