오류
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Bid Manager API에 수행한 요청을 완료할 수 없는 경우 오류가 반환됩니다.
메시지가 표시됩니다. 오류 메시지를 파싱하고 적절하게 처리하여
발생할 수 있습니다. 오류를 반환하는 요청은 사용자 할당량과 오류율을 사용합니다.
추가 할당량에 대한 요청을 검토할 때 고려됩니다.
오류 응답은 다음과 같은 형식이며 HTTP 응답 코드를 포함합니다.
오류 메시지, Google RPC 코드 상태가 표시됩니다.
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
다음은 일반적인 API 오류 목록과 다음과 같은 경우 권장되는 조치입니다.
다음과 같이 반환됩니다.
오류 코드 및 RPC 관련 권장 조치 |
400 INVALID_ARGUMENT
|
요청에 문제가 있습니다.
오류 응답의 메시지 필드를 검토하고 요청을 수정합니다.
이에 따라 조치를 취하세요.
캠페인의 요약 정보를 찾는 데 문제가 있다면
필터, 측정기준 및 측정항목의 조합에 대해 자세히 알아보려면
가장 우수한 실적 보고
권장사항을 참고하세요. |
401 UNAUTHENTICATED
|
요청을 제대로 처리할 수 없습니다
있습니다. 다음 위치에 유효한 OAuth 사용자 인증 정보를 포함하고 있는지 확인
요청할 수 있습니다 자세한 내용은
시작하기
가이드를 참조하세요. |
404 NOT_FOUND
|
이
Query 드림
또는
Report
실행하려고 하거나 검색하려는 검색 결과( )를 찾을 수 없습니다.
있습니다.
<ph type="x-smartling-placeholder">
|
429 RESOURCE_EXHAUSTED
|
API 요청 할당량 또는
보고 할당량:
오류 메시지를 읽고 초과된 할당량 유형을 확인합니다.
<ph type="x-smartling-placeholder">
|
500 INTERNAL
|
API에 내부 오류가 발생했습니다. 사용
지수
백오프 오류 처리 전략을 사용하여 대기 후 요청을 재시도합니다. 만약
오류가 계속되면 문의해 주세요.
지원을 참조하세요. |
504 DEADLINE_EXCEEDED
|
API에서
합니다. 사용
지수
백오프 오류 처리 전략을 사용하여 대기 후 요청을 재시도합니다. 만약
오류가 계속되면 문의해 주세요.
지원을 참조하세요. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eBid Manager API request errors impact user quota and can be avoided by properly handling error messages.\u003c/p\u003e\n"],["\u003cp\u003eError responses provide specific codes, messages, and statuses to help diagnose and resolve issues.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors include invalid arguments, authentication failures, resource exhaustion, and internal server errors.\u003c/p\u003e\n"],["\u003cp\u003eRecommended actions for common errors involve reviewing the request, verifying credentials, and adjusting API usage.\u003c/p\u003e\n"],["\u003cp\u003ePersistent errors after implementing recommended actions necessitate contacting support for further assistance.\u003c/p\u003e\n"]]],[],null,["# Errors\n\nRequests made to the Bid Manager API that can't be completed return an error\nmessage. Error messages should be parsed and appropriately handled to avoid\nfuture errors. Requests returning errors consume user quota, and error rates\nare considered when reviewing requests for additional quota.\n\nAn error response has the following format and includes an HTTP response code,\nan error message, and a [Google RPC code](//cloud.google.com/apis/design/errors#handling_errors) status: \n\n```gdscript\n{\n \"error\": {\n \"code\": integer,\n \"message\": string,\n \"status\": enum (google.rpc.Code)\n }\n}\n```\n\nHere's a list of common API errors along with the recommended action to take if\nthey are returned:\n| **Note:** If the error persists even after taking the recommended action, [contact\n| support](/bid-manager/support/contact) to report the issue.\n\n| Recommended Actions for error code and RPC ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `400` `INVALID_ARGUMENT` | There's an issue with your request. Review the message field in the error response, and modify your request accordingly. If you are experiencing issues with finding an acceptable combination of filters, dimensions, and metrics, refer to our [reporting best practices](/bid-manager/guides/general/best-practices) for recommendations. |\n| `401` `UNAUTHENTICATED` | Your request couldn't be properly authenticated. Verify that you are including valid OAuth credentials in your request. For more information, see the [Get Started guide](/bid-manager/guides/get-started/overview). |\n| `404` `NOT_FOUND` | The [`Query`](/bid-manager/reference/rest/current/queries#Query) or [`Report`](/bid-manager/reference/rest/current/queries.reports#Report) you are attempting to run or retrieve cannot be found. Verify the following: - The resource ID is correct - The resource type is valid for the endpoint - The resource in question was [created by the accessing user](/bid-manager/guides/general/best-practices#build_new_reports_in_the_ui_first) |\n| `429` `RESOURCE_EXHAUSTED` | You have exceeded either your [API request quota](/bid-manager/quotas) or [reporting quota](/bid-manager/guides/general/best-practices#consider_reporting_quotas). Read the error message to determine what type of quota you are exceeding: - API request quota: Examine your API usage using the [Google Cloud Console](//console.developers.google.com/project/_/apiui/apiview/doubleclickbidmanager.googleapis.com/metrics), and modify your workflow to operate within the existing quota limits. If your operations can't be completed within your given daily quota, [request additional quota](/bid-manager/quotas#additional_quota). - Reporting quota: Review [existing reporting quota best practices](/bid-manager/guides/general/best-practices#consider_reporting_quotas) and reach out to [Display \\& Video 360 product support](//support.google.com/displayvideo/contact/nghelp_contact_form) if needed. |\n| `500` `INTERNAL` | The API experienced an internal error. Use the [exponential backoff error handling strategy](/bid-manager/guides/general/best-practices#exponential_backoff) to wait and retry the request. If the error persists, [contact support](/bid-manager/support/contact). |\n| `504` `DEADLINE_EXCEEDED` | The API took too long to complete the request. Use the [exponential backoff error handling strategy](/bid-manager/guides/general/best-practices#exponential_backoff) to wait and retry the request. If the error persists, [contact support](/bid-manager/support/contact). |"]]