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,以及此表格列中的程式碼和原因 (而非下方列的程式碼)。

410

報表未取得配額配額

開發人員專案今天要求的資料過多,因此系統已停止處理這份報表。

確保客戶傳送的要求數量沒有超出預期。您可以在 Google Cloud Console 中追蹤配額用量。

如果你的用戶端成效符合預期,請與 Search Ads 360 客戶服務團隊聯絡並要求提高配額。請填入您的開發人員專案編號,以及這份表格 (而非上述的列) 的程式碼和原因。

另請參閱定價與用量限制

410

reportUnavailableInternalServerError

發生未預期的原因,Search Ads 360 無法傳回或產生報表。

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

410

reportUnavailableRequestError

即使請求已通過驗證,Search Ads 360 也無法產生您要求的報表,因為該報表內含無效的欄、篩選器及區隔組合。

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

如有任何其他類型的錯誤,API 會傳回標準錯誤回應