Search Ads 360 API 中的回應代碼

如果 Search Ads 360 API 要求成功,API 會在回應本文中傳回 200 HTTP 狀態碼及所要求的資料。

如果要求驗證失敗,API 會傳回 400499 之間的 HTTP 狀態碼,以及驗證錯誤的說明。

如果您傳送有效的 Report.get() 要求,但 Search Ads 360 無法產生報表,API 就會傳回下列其中一個 HTTP 狀態碼。

程式碼 原因 說明 建議採取的行動

410

reportUnavailableRequestTooLarge

由於報表過大,系統已停止處理。

請改為要求多份較小的報表。例如,將單一廣告主報表拆分為多個引擎帳戶報表。或者,將一年的報表分成 12 個月的報表。

410

reportUnavailableRateLimitExceeded

由於開發人員專案在短時間內要求過多報表,因此系統已停止處理報表。

確認您的用戶端不會傳送比預期頻繁的請求。

如果客戶的表現符合預期,請與 Search Ads 360 客戶服務團隊聯絡。請提供開發人員專案 ID,以及這個表格資料列中的「Code」和「Reason」(而非下方資料列)。

410

reportUnavailableQuotaExceeded

由於開發人員專案今天要求的資料過多,因此系統不再處理報表。

請確認您的用戶端不會傳送比預期更大的請求。您可以在 Google Cloud 控制台追蹤配額用量。

如果客戶的表現符合預期,請與 Search Ads 360 客戶服務團隊聯絡,要求提高配額。請提供開發人員專案 ID,以及這個表格資料列中的「Code」和「Reason」(而非上一個資料列)。

另請參閱「定價和用量限制」。

410

reportUnavailableInternalServerError

由於某些非預期原因,Search Ads 360 無法傳回或產生報表。

與 Search Ads 360 客戶服務團隊聯絡。請附上報表 ID。

410

reportUnavailableRequestError

即使要求通過驗證,Search Ads 360 仍無法產生要求的報表,因為報表含有無效的資料欄、篩選器和區隔組合。

與 Search Ads 360 客戶服務團隊聯絡。請附上報表 ID。

400

unsupportedApiVersion

不支援的版本。

改用 Search Ads 360 Reporting API。

對於所有其他類型的錯誤,API 會傳回標準錯誤回應