Search Ads 360 API 中的回應代碼
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如果 Search Ads 360 API 要求成功，API 會在回應本文中傳回 200 HTTP 狀態碼及所要求的資料。
如果要求驗證失敗，API 會傳回 400 和 499 之間的 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 會傳回標準錯誤回應。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-12-05 (世界標準時間)。
[null,null,["上次更新時間：2024-12-05 (世界標準時間)。"],[[["\u003cp\u003eSearch Ads 360 API returns a \u003ccode\u003e200\u003c/code\u003e HTTP status code for successful requests and a status code between \u003ccode\u003e400\u003c/code\u003e and \u003ccode\u003e499\u003c/code\u003e for validation failures.\u003c/p\u003e\n"],["\u003cp\u003eIf a valid report request cannot be generated, the API returns a \u003ccode\u003e410\u003c/code\u003e status code with a specific reason, such as the report being too large, rate limit exceeded, or internal server error.\u003c/p\u003e\n"],["\u003cp\u003eFor report generation failures, recommended actions include requesting smaller reports, checking client request frequency, contacting support for quota increases, or reviewing report configurations.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides detailed descriptions and recommended actions for each type of report generation failure, helping users troubleshoot and resolve issues effectively.\u003c/p\u003e\n"],["\u003cp\u003eFor other errors, refer to the Standard Error Responses documentation for guidance.\u003c/p\u003e\n"]]],["Successful Search Ads 360 API requests return a `200` status code. Validation failures result in `400-499` codes, with error descriptions. If report generation fails, `410` codes indicate issues like excessive size, rate limits, quota overages, internal errors, or invalid report specifications; each with specific resolution steps. A `400` error indicates an unsupported API version. Other errors follow standard error responses.\n"],null,["# Response Codes in the Search Ads 360 API\n\nIf a request to the Search Ads 360 API is **successful** , the API returns\na `200` HTTP status code along with the requested data in the body of the response.\n\nIf a request **fails to validate** , the API returns an HTTP status code between\n`400` and `499` along with a description of the validation error.\n\nIf you send a valid [`Report.get()`](/search-ads/v2/reference/reports/get)\nrequest but Search Ads 360 is **unable to generate a report**, the API returns\none of the HTTP status codes described below.\n\n| Code | Reason | Description | Recommended action |\n|------|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 410 | reportUnavailableRequestTooLarge | The report is no longer being processed because the report is too large. | Request multiple smaller reports instead. For example, break a single advertiser report into multiple engine account reports. Or break a year-long report into 12 month long reports. |\n| 410 | reportUnavailableRateLimitExceeded | The report is no longer being processed because too many reports were requested by the developer project in a short amount of time. | Make sure your client isn't sending requests more frequently than you intend. If your client is performing as expected, [contact Search Ads 360 customer support](https://support.google.com/searchads/answer/3280641). Include your developer project ID, and the Code and Reason from this table row (and not the one below). |\n| 410 | reportUnavailableQuotaExceeded | The report is no longer being processed because too much data has been requested by the developer project today. | Make sure your client isn't sending larger requests than you intend. You can keep track of your quota usage in Google Cloud Console. If your client is performing as expected, [contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876) and ask for a quota increase. Include your developer project ID, and the Code and Reason from this table row (and not the one above). Also see [Pricing and Usage Limits](/pricing). |\n| 410 | reportUnavailableInternalServerError | Search Ads 360 is unable to return or generate the report for some unexpected reason. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 410 | reportUnavailableRequestError | Even though the request passed validation, Search Ads 360 cannot generate the requested report because it contains an invalid combination of columns, filters, and segmentations. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 400 | unsupportedApiVersion | Version not supported. | Migrate to the Search Ads 360 Reporting API. |\n\nFor all other types of errors, the API returns\n[Standard Error Responses](/search-ads/v2/standard-error-responses)."]]
