Google Shopping Content API 正式退役：產品資料同步開始斷線，香港電商立即檢查
緊急：你嘅產品資料可能已經靜靜地斷線
如果你係香港電商網站嘅營運者、市場推廣經理或技術負責人，呢篇文章你一定要睇。Google 嘅舊版 Content API for Shopping 已經喺 2026 年 8 月 18 日正式 sunset，並由 2026 年 9 月 1 日起開始間歇性拒絕請求——你嘅產品資料同步可能已經無聲無息咁斷咗線。
根據 Google 官方文件，由 9 月 1 日開始，未獲批准延期嘅 API 請求會間歇性回覆 HTTP 410 Gone 錯誤，代表 Google 已經正式淘汰呢個舊 API。到 2027 年初，所有端點將會完全關閉。
背景：Content API 與 Merchant API 的區別
Google Content API for Shopping 係多年嚟電商網站用嚟程式化上傳產品資料、價格同庫存到 Merchant Center 嘅主要方法。無論你係用 Shopify、WooCommerce、Magento、BigCommerce 定係自訂系統，背後都可能依賴呢個 API 將產品資料同步到 Google Shopping 同免費產品 listing。
Google 喺 2025 年開始推動新版 Merchant API，呢個新 API 採用模塊化設計，將功能拆分為多個子 API（Products、Inventories、Reports、Promotions 等），並使用全新嘅命名結構同認證方式。
主要變化一覽
| 功能 | Content API (舊) | Merchant API (新) |
|---|---|---|
| 狀態 | ❌ 已淘汰（間歇性失敗） | ✅ 活躍中 |
| URL 格式 | shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} | merchantapi.googleapis.com/products/v1/{name} |
| 產品 ID | merchantId + productId | 統一名稱 (name) |
| 價格格式 | 字串 decimal | int64 micros（100 萬 = 1 單位） |
| 批量操作 | customBatch 方法 | 不支援，需使用異步請求 |
| 子 API 結構 | 單一 API | 模塊化子 API（Products、Inventories、Reports 等） |
香港電商：你受影響嗎？
唔同嘅平台同整合方式受影響程度唔同：
使用 Shopify、WooCommerce、BigCommerce 等平台
如果你係透過電商平台嘅內置整合連接到 Google Merchant Center，通常你嘅平台供應商已經負責咗遷移工作。你只需要聯絡平台支援確認已經更新咗，或者查看平台嘅官方公告。
使用第三方 Feed 管理工具
如果你用緊 Product Feed 管理工具（例如 DataFeedWatch、GoDataFeed、Feedonomics 等），同樣需要確認工具供應商已經從 Content API 遷移到 Merchant API。如果未遷移，你嘅產品資料可能會出現斷續同步失敗。
自訂開發整合（Custom Integration）
如果你嘅團隊有自行開發嘅 API 整合、自訂 feed 腳本或中介軟體直接呼叫 Content API，呢個係最高風險組別。由 9 月 1 日起，你嘅請求會間歇性失敗，導致產品資料更新唔完整，最終影響 Shopping 廣告同免費 listing 嘅展示。
如何檢查你嘅整合是否受影響
- 登入 Google Merchant Center → 進入「Diagnostics」（診斷）分頁，檢查有冇突然增加嘅 feed 錯誤
- 檢查 API 日誌——如果你有 API 存取日誌，搜尋有冇
HTTP 410 Gone或content_api_sunset錯誤訊息 - 查看產品資料數量——如果 Merchant Center 嘅產品數量突然下降，可能係 feed 同步已經出現問題
- 檢查 Google Shopping 廣告——如果廣告曝光或點擊突然下跌，可能係因為產品資料無法正常同步
遷移到 Merchant API 嘅三步行動計劃
第一步：評估風險（今日做）
確認你嘅系統使用緊邊個 API。最簡單嘅方法係檢查你嘅 feed 或整合程式碼中有冇 shoppingcontent.googleapis.com/content/v2.1 嘅 URL。如果有，你仲未遷移。
第二步：申請延期（如果需要更多時間）
如果你需要額外時間完成遷移，可以提交 Google 嘅 Content API extension request 申請延期。獲批嘅延期可以暫時保護你嘅項目免受錯誤回應影響。
第三步：執行遷移
按照 Google 官方遷移指南：
- 閱讀 Merchant API 概覽，了解新嘅架構同認證方式
- 將 API 請求 URL 從 Content API 格式改為 Merchant API 格式
- 將價格欄位由字串 decimal 改為 int64 micros（100 萬 micros = 1 港元）
- 更新產品識別方式，由 merchantId + productId 改為 name 格式
- 喺開發環境測試，確認一切正常後先部署到生產環境
香港電商緊急檢查清單
立即執行檢查清單
- □檢查 Merchant Center Diagnostics——登入 Google Merchant Center，確認有冇新出現嘅 feed 錯誤或產品拒批
- □確認平台供應商狀態——如果你用 Shopify、WooCommerce 等平台，向支援團隊確認「你哋已經遷移到 Merchant API 未？」
- □掃描 API 日誌——搜尋有冇
HTTP 410或content_api_sunset錯誤 - □申請延期（如有需要）——如果未完成遷移，立即申請延期避免服務中斷
- □檢查 Shopping 廣告數據——確認廣告曝光同點擊率冇異常下跌
- □制定遷移時間表——如果係自訂整合，制定明確嘅 Merchant API 遷移計劃，目標喺 2027 年初前完成
- □監控產品數量——每週檢查 Merchant Center 嘅活躍產品數量，確保同步正常
總結：時間已經唔等人
Google Content API for Shopping 嘅 sunset 唔係突發事件——Google 已經提前多月發出通知。但對於香港電商嚟講，9 月 1 日嘅間歇性失敗可能已經影響到你嘅產品 listing。
每延遲一日遷移，你嘅 Shopping 廣告同免費 listing 都暴露喺資料同步失敗嘅風險中。建議立即執行以上檢查清單，確認你嘅產品資料仲係咪正常運作。
資料來源：Google Developers — Content API for Shopping Deprecation and Sunset · Google Developers — Migrate from Content API for Shopping to Merchant API · Invasion24 — Google Shopping Content API hits its sunset