Search Ads 360 API의 응답 코드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Search Ads 360 API 요청이 성공하면 API는 응답 본문에서 요청된 데이터와 함께 200 HTTP 상태 코드를 반환합니다.
요청 유효성 검사에 실패하면 API는 유효성 검사 오류 설명과 함께 400과 499 사이의 HTTP 상태 코드를 반환합니다.
유효한 Report.get() 요청을 전송했지만 Search Ads 360에서 보고서를 생성할 수 없는 경우 API는 아래에 설명된 HTTP 상태 코드 중 하나를 반환합니다.
| 코드 |
이유 |
설명 |
권장 조치 |
410 |
reportUnavailableRequestTooLarge |
보고서가 너무 커서 더 이상 처리되지 않습니다. |
대신 더 작은 보고서를 여러 개 요청하세요. 예를 들어 단일 광고주 보고서를 여러 엔진 계정 보고서로 분할합니다. 또는 1년 보고서를 12개월 보고서로 분할할 수 있습니다. |
410 |
reportUnavailableRateLimitExceeded |
개발자 프로젝트에서 단시간에 너무 많은 보고서를 요청했기 때문에 더 이상 보고서가 처리되지 않습니다. |
클라이언트가 의도한 것보다 더 자주 요청을 전송하지 않는지 확인합니다.
고객이 정상적으로 작동하는 경우 Search Ads 360 고객 지원팀에 문의하세요.
개발자 프로젝트 ID와 이 표 행의 코드 및 이유(아래가 아님)를 포함합니다.
|
410 |
reportUnavailableQuotaExceeded |
오늘 개발자 프로젝트에서 너무 많은 데이터를 요청했기 때문에 보고서가 더 이상 처리되지 않습니다. |
클라이언트가 의도한 것보다 큰 요청을 전송하지 않는지 확인합니다. Google Cloud 콘솔에서 할당량 사용량을 추적할 수 있습니다.
고객 실적이 예상대로 나오는 경우 Search Ads 360 고객 지원팀에 문의하여 할당량 증대를 요청하세요. 개발자 프로젝트 ID와 이 표 행의 코드 및 이유 (위의 행이 아님)를 포함합니다.
가격 및 사용 한도도 참고하세요.
|
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는 표준 오류 응답을 반환합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-05(UTC)
[null,null,["최종 업데이트: 2024-12-05(UTC)"],[[["\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)."]]
