淘汰與停用

Google Content API for Shopping 已於 2026 年 8 月 18 日正式終止服務。 所有開發人員都必須盡快將現有整合項目遷移至 Merchant API

為鼓勵開發人員在全面停用前完成遷移,並確保他們在應用程式記錄中注意到淘汰通知,Google 將於 2026 年 9 月 1 日開始,逐步降低服務品質。

停用時間表

下表列出 Google Content API for Shopping (v2.1) 服務效能下降和最終停用的時間表:

日期 Milestone 詳細資料
2026 年 9 月 1 日 間歇性失敗要求簡介 如果沒有有效的擴充功能,要求會開始間歇性失敗,並顯示 HTTP 410 Gone
2027 年初 停用 全面關機。所有端點都會關閉,所有要求都會失敗。

服務效能降低和錯誤回應

自 2026 年 9 月 1 日起,如果用戶端未申請延長期限,傳送至 Google Content API for Shopping 端點的要求會間歇性失敗,並顯示 HTTP 410 Gone 狀態碼。

錯誤回應格式

如果要求因排定的服務降級而遭拒,API 會傳回 HTTP 410 Gone 錯誤酬載,其中包含訊息和中繼資料,以及您的 Google Cloud 雲端專案詳細資料:

{
  "error": {
    "code": 410,
    "message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
    "status": "ABORTED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "content_api_sunset",
        "domain": "shoppingcontent.googleapis.com",
        "metadata": {
          "GCP_ID": "YOUR_PROJECT_ID",
          "GCP_NUMBER": "YOUR_PROJECT_NUMBER",
          "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
        }
      }
    ]
  }
}

錯誤回應包含下列中繼資料欄位:

  • GCP_ID:發出要求的 Google Cloud 專案 ID。
  • GCP_NUMBER:Google Cloud 專案的專屬數值 ID。
  • HELP_CENTER_LINK:遷移說明文件的直接連結。

配額影響

服務降級期間產生的錯誤回應不會計入專案的 API 配額。

重試失敗的要求

由於服務效能下降初期只會導致部分要求失敗,因此重試失敗的要求可能會成功。不過,依賴重試並非可行的長期解決方案,因為在停用之前,要求失敗的頻率會越來越高,直到所有要求都失敗為止。

受影響的開發人員

淘汰和服務降級程序適用於開發人員和企業,如下所示:

  • 自訂 API 整合:如果貴機構維護內部工具、指令碼或自訂軟體,直接呼叫 Google Content API for Shopping,您必須更新應用程式來呼叫 Merchant API。
  • 第三方平台:如果你透過電子商務平台存取 Merchant Center,平台合作夥伴會代為管理遷移作業。您無須採取任何行動。

敬請採取行動

為避免產品資訊和帳戶管理作業中斷:

  1. 請參閱Merchant API 總覽,瞭解架構、驗證和子 API 結構。
  2. 請按照「從 Content API for Shopping 遷移至 Merchant API」操作指南,找出目前 Content API 服務的現代化對應項目。
  3. 為您的程式設計語言安裝最新版Merchant API 用戶端程式庫
  4. 在部署至正式環境前,請先在開發環境中更新及測試整合。

申請延期

如果貴機構需要更多時間完成遷移作業,可以申請延期,暫時免除 Google Cloud 專案的服務降級錯誤。如要申請延長期限,請提交內容 API 延長期限申請表

在核准的擴充功能時間範圍內,核准的擴充功能可保護專案免於排定的錯誤回應。2027 年初最終停用後,擴充功能將不再適用。