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,平台合作夥伴會代為管理遷移作業。您無須採取任何行動。
敬請採取行動
為避免產品資訊和帳戶管理作業中斷:
- 請參閱Merchant API 總覽,瞭解架構、驗證和子 API 結構。
- 請按照「從 Content API for Shopping 遷移至 Merchant API」操作指南,找出目前 Content API 服務的現代化對應項目。
- 為您的程式設計語言安裝最新版Merchant API 用戶端程式庫。
- 在部署至正式環境前,請先在開發環境中更新及測試整合。
申請延期
如果貴機構需要更多時間完成遷移作業,可以申請延期,暫時免除 Google Cloud 專案的服務降級錯誤。如要申請延長期限,請提交內容 API 延長期限申請表。
在核准的擴充功能時間範圍內,核准的擴充功能可保護專案免於排定的錯誤回應。2027 年初最終停用後,擴充功能將不再適用。