掌握新功能、修正錯誤和版本更新的最新公告。
2026 年 8 月
2026 年 8 月
新功能:
- Content API for Shopping 已於 2026 年 8 月 18 日終止服務。所有開發人員都必須盡快將現有整合項目遷移至 Merchant API。詳情請參閱「淘汰和終止」。
- 通用商務通訊協定 (UCP) 帳戶整合:在 Account Service 資源中新增
UcpCheckoutManagement做為服務類型,並支援ucp-integration計畫和ucp_integration服務條款 (存取權有限)。 - 商品層級退貨政策覆寫:在
ProductAttributes中新增returns屬性,直接在商品層級設定及覆寫退貨政策 (例如國家/地區、退貨期限天數、退貨費用、商品狀況)。 - 房地產租賃屬性:在
ProductAttributes中新增主要房源屬性 (包括leaseTerm),用於提交租賃廣告資料。 - Inventories sub-API 強化功能:
- 在
LocalInventoryAttributes中新增localShippingLabel,用於設定商店專屬運送規則。 - 在
LocalInventoryAttributes中新增customAttributes,支援店面商品目錄資料的自訂中繼資料。
- 在
- 帳戶服務通知:在 Notifications 子 API 中新增
ACCOUNT_SERVICE做為支援的NotificationEventType,以便追蹤帳戶服務的狀態變更。如要進一步瞭解帳戶服務異動通知,請參閱「接收帳戶服務異動的推播通知」。 - YouTube Shopping 聯盟報表資料檢視 (
v1alpha):youtube_product_sold_stats_view:查詢 YouTube 聯盟產品的銷售業績。youtube_product_tagged_stats_view:追蹤影片中標記產品的曝光次數、點擊次數和訂單。
- 會員目標顧客比對端點:上傳及管理顧客會員資料,在自然搜尋結果中顯示會員等級福利 (例如會員價)。如要進一步瞭解顧客忠誠度資料,請參閱「會員目標顧客比對服務總覽」。
- Alpha 版用戶端程式庫公開存放區:公開 GitHub 存放區現已提供評論子 API 的 Alpha 版程式庫,支援 Python、Java、PHP、C#、Ruby、Node.js 和 Go。
異動內容:
ListAccounts存取層級篩選器:推出access參數,支援DIRECT、INDIRECT和ALL,可根據呼叫端權限篩選帳戶。可用來區分進階帳戶和子帳戶。DataSources配額和規則驗證:- 針對進階帳戶的資料來源,推出自動配額管理功能。詳情請參閱「瞭解配額與限制」。
- 新增規則驗證,要求主要產品資料來源中的預設規則,必須包含一個對
self或主要資料來源的參照。 - 淘汰
DataSourceReference中的primaryDataSourceName,改用self。
- 縮短延遲時間:減少插入、更新和刪除產品 API 呼叫的負擔。
後續計畫:
- Content API for Shopping 淘汰和停用:提醒您改用新版 Merchant API。為鼓勵開發人員在完全停用前完成遷移,並確保他們注意到應用程式記錄中的淘汰通知,Google 將從 2026 年 9 月 1 日起,逐步降低服務品質。詳情請參閱 Content API for Shopping 的淘汰時間表一節。
2026 年 5 月
2026 年 5 月
新功能:
- 全新的 Merchant API MCP 服務 (Alpha 版) 現已推出,可做為 Merchant API 的新代理工具,授權存取 Merchant Center 資料和洞察資料,並著重於唯讀功能。
新的對話式屬性現已在 Products sub-API 的
ProductAttributes下提供。這些屬性包括:
Products 子 API 已新增一組完整的車輛廣告專用屬性。
Notifications 子 API 現已提供通用商務通訊協定 (UCP) 結帳的產品狀態變更通知,可透過報表情境值
FREE_LISTINGS_UCP_CHECKOUT取得。Merchant API Agent Skills 是 Code Assist Toolkit 中的全新代理工具。新的
mapi-developer-assistant技能以開放式 Agent Skills 標準為基礎,可提供智慧型和情境式協助。這項服務提供特定領域的專業知識、自動化工作流程,並提升 Antigravity CLI 和 IDE 等 AI 工具的效率,加快整合速度。新版 YouTube 子 API v1alpha 可用於管理 YouTube 聯盟計畫合約。
Accounts 子 API 新增支援功能,可管理 YouTube Shopping 聯盟和產品評論計畫。
進階帳戶層級的產品促銷活動,現在可使用新的資料來源。
異動內容:
- Merchant API (v1beta) 已終止服務。現在所有 API 呼叫都必須導向
v1或v1alpha版本。如要瞭解遷移步驟,請參閱「從 v1beta 遷移至 v1」。 - 現在可透過 Products 子 API 中的
patch方法,更頻繁地更新price和availability的屬性層級。這項功能可縮短更新這些特定屬性的延遲時間,提高資料更新間隔。目前僅開放給許可清單中的商家。如要瞭解詳情或申請存取權,請洽詢 Google 代表。
後續計畫:
- 透過 Reports API 中的 UCP,分析代理成效。
2026 年 1 月
2026 年 1 月
新功能:
新的報表情境值
FREE_LISTINGS_UCP_CHECKOUT,用於瞭解 Reports sub-API 中通用商務通訊協定 (UCP) 結帳的產品資格狀態。Reports 子 API 的 v1alpha 推出 YouTube Shopping 聯盟成效報表。
新增對
ErrorInfo訊息的支援,為錯誤的 API 呼叫提供機器可讀的中繼資料。此外,我們也提供新的錯誤處理指南和完整的錯誤訊息清單。
異動內容:
- 在店面商品目錄資料服務中新增
InventoryLoyaltyProgram,讓使用者能整合控制會員功能,例如折扣、未來消費現金回饋和會員點數。
後續計畫:
- Merchant API v1beta 將於 2026 年 2 月 28 日終止服務。請在 v1beta 淘汰期限前,將所有 API 呼叫分別導向 v1 和 v1alpha 版本。
- 可透過 Reviews API v1alpha 啟用和停用產品評論計畫,簡化產品評論的提交和管理程序。
2025 年 11 月
2025 年 11 月
新功能:
- YouTube Shopping 聯盟數據分析 (v1alpha) 的新洞察資料,可在 Reports 子 API 中擷取 YouTube 創作者、內容和產品的數據分析。這項服務與 Google Merchant Center (GMC) 現有的報表功能相同。
- 升級版 API 診斷工具,可協助遷移至 Merchant API(v1)。
- 在 Accounts 子 API 中新增
product_filters欄位,讓商家根據產品屬性的條件篩選器,只與 Google Ads 帳戶共用部分動態饋給。這項功能僅開放給部分商家使用。 - 新增支援電子商務平台賣家建立獨立帳戶。
- 新增
accounts.limits.get和accounts.limits.list兩種方法,用於在 Quota API 中查詢帳戶相關限制。
異動內容:
- 現在,所有使用產品 ID 的方法都支援自動偵測及內部解碼 base64url 編碼的產品 ID。
後續計畫:
YouTube Shopping 聯盟數據分析 (v1alpha) 的新洞察資料,可在 Reports 子 API 中擷取 YouTube 創作者、內容和產品的數據分析。這項服務與 Google Merchant Center (GMC) 現有的報表功能相同。
Merchant API 的 v1beta 版本將於 2026 年 2 月 28 日終止服務。在 v1beta 停用期限前,所有 API 呼叫都必須分別導向 v1 和 v1alpha 版本。詳情請參閱「Merchant API 版本管理和淘汰政策」。
2025 年 9 月
2025 年 9 月
新功能:
- Merchant API 的第一個 Model Context Protocol (MCP) 服務已推出。
- 這項新的 MCP 服務將權威性的 Google API 說明文件,整合至整合式開發環境 (IDE) 程式開發輔助,加快 Merchant API 整合速度,並提高遷移工作流程的準確度。
- Accounts 子 API 中新增了
getAccountForGcpRegistration方法,可用於擷取向 Google Cloud 註冊的商家帳戶。
異動內容:
- Accounts 子 API 中管理區域的新方法。
- 推出
batchCreate、batchDelete和batchUpdate三種新方法,可對 Accounts 子 API 中區域的create、update和delete作業進行呼叫批次處理,以便管理區域,並減輕one-region-per-request呼叫的限制。
- 推出
- Products 子 API 提供新的貨運公司運送設定,可用於指定產品層級的運送屬性。
後續計畫:
- YouTube Shopping 聯盟計畫數據分析的新報表,例如 Reports 子 API 中的 v1alpha,可擷取 YouTube 上創作者、內容和產品的數據分析,與 Google Merchant Center 提供的報表相同。
- 更頻繁地更新產品的供應情形和價格屬性。
- ErrorInfo 和中繼資料更豐富,分析 API 錯誤更輕鬆。
2025 年 7 月
2025 年 7 月
新功能:
Merchant API (v1) - Content API for Shopping 的官方後繼版本現已正式發布。
也就是說,Merchant API 日後只會有 v1alpha 和 v1 子 API,且大多數 v1beta 版本都會升級至 v1。敬請關注後續消息。
有新資源。
- Product Studio API (Alpha 版) 的圖片資源會運用生成式 AI,生成新的產品背景、移除圖片背景,以及提高圖片解析度。
- Accounts sub-API 的 Checkout on Merchant 可用於建立、更新、刪除及取得結帳設定。
- Accounts 子 API 中的線上退貨政策已遷移,使用者功能維持不變。為求一致,我們已移除過時欄位和重新命名現有欄位等小型技術改善項目。
- Accounts 子 API 中 AccountRelationshipAccountRelationship 資源的
AccountIdAlias會使用使用者定義的別名,而非內部 ID (帳戶 ID)。這樣一來,您就能更輕鬆地管理複雜的帳戶結構,例如使用市集的使用者定義別名,而非內部 ID。
Apps Script 使用者現在可以存取 Merchant API。
Issue Resolution API 現在提供新的
AggregateProductStatuses方法,可用於查詢產品狀態的匯總統計資料。
異動內容:
- 可為開店平台和 CSS 建立獨立帳戶。先前,商家帳戶是在單一進階帳戶下建立。
在報表子 API 下方的
productView表格中,點擊次數潛力排名。現在,系統會將產品依clickPotential排名的值正規化為 1 到 1000 之間。clickPotentialRank較低的產品,在符合搜尋查詢條件的商家產品中,click potential仍最高。
後續計畫:
- 透過 Model Context Protocol (MCP) 伺服器 (v1alpha) 存取。
2025 年 5 月
2025 年 5 月
新功能:
- 我們推出了兩個新的子 API。
- Accounts 子 API 中有新資源。
OmnichannelSettings管理全通路放送的帳戶設定,例如免費區域產品資訊 (FLL) 和店面商品目錄廣告 (LIA)。LfpProviders連結至店面動態饋給合作夥伴 (LFP) 合作夥伴,取得商品目錄資料。GbpAccounts連結至 Google 商家檔案帳戶,取得本地商店資料。OnlineReturnPolicy可讓您建立、刪除及更新線上政策。
- Products 子 API 提供新方法。
ProductsUpdate可讓您更新個別產品,不必提供ProductInput的所有必填欄位。
異動內容:
pageSize上限從每次 API 呼叫 250 列提高到 1000 列。- 修正了在
DataSources建立後,產品插入、促銷活動、產品評論和商家評論會延遲的問題。
後續計畫:
DataSources和產品的管道欄位已淘汰,日後將移除。- Reports 子 API 下方
productView表格中的clickPotentialRank更新定義:- 系統會將根據
clickPotential排名的產品正規化為 1 到 1000 之間的值。 - 即使產品的
clickPotentialRank偏低,只要符合搜尋查詢條件,在商家的產品中仍具有最高的點擊次數潛力。這項非破壞性變更可能於 2025 年 7 月 1 日推出。
- 系統會將根據
AccountRelationship資源中的AccountIdAlias可讓您更妥善管理複雜的帳戶結構。舉例來說,市集會使用使用者定義的別名,而非商家的內部 ID (例如帳戶 ID)。
2025 年 4 月
2025 年 4 月
新功能:
- 我們推出了新的子 API。
- Product Studio (Alpha 版) 運用生成式 AI 產生及最佳化產品名稱和說明。
- Accounts 子 API 提供新資源。
AutomaticImprovements管理 Google Merchant Center 平台提供的三項自動更新功能:選擇加入AccountService和AccountRelationship資源會管理關係,並建立服務與服務供應商之間的連結。
- 我們在產品子 API 中,為
AutomatedDiscounts推出三個欄位,用於擷取已啟用 Google 自動折扣 (GAD) 的產品即時價格。
異動內容:
- 我們現在支援 Data Sources sub-API 的目的地,在 Merchant Center 中稱為行銷方式。
- 我們對資源進行了多項調整,建議您參閱帳戶版本資訊,瞭解詳情。
- Products sub-API 中的
taxes和tax_category欄位已淘汰,Content API 中的accounttax也已淘汰。
後續計畫:
- 我們已考量您的意見回饋,並著手改善 API 開發人員說明文件的多個部分。
- 請密切關注並經常回來查看,也歡迎提供更多意見回饋。