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