일반적인 오류
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 Google Ad Manager API에서 가장 자주 발생하는 오류를 설명합니다. 오류는 Error.REASON 형식으로 반환됩니다.
EntityChildrenLimitReachedError
- 요약
- 항목에 허용되는 최대 하위 요소 수에 도달했으며 해당 항목에 더 이상 하위 요소를 추가할 수 없습니다.
- 권장 해결 방법
- 하위 항목의 최대 허용 개수에 도달한 항목의 새로운 유형을 만들고 만들려는 하위 항목을 새 항목에 추가합니다.
예를 들어 LINE_ITEM_LIMIT_FOR_ORDER_REACHED를 수신하는 경우 새 주문을 만들고 만들려는 광고 항목을 새 주문에 추가해야 합니다.
QuotaError.EXCEEDED_QUOTA
- 요약
- 초당 요청 수가 너무 많아 허용 한도를 초과했습니다.
- 권장 해결 방법
-
- 변경사항을 로컬로 수집하고 이러한 변경사항을 한 번에 처리하는 단일 요청을 실행하여 updateLineItems와 같은 일괄 메서드를 사용합니다.
- 5초 정도 기다린 후 요청을 재시도합니다. 이렇게 한다고 해서 요청이 성공할 것이라는 보장은 없습니다. 다시 실패하면 대기 시간을 늘려 보세요. 실시간으로 사용되는 Ad Manager와 통합되는 양방향 애플리케이션에
권장됩니다.
- 요청을 Ad Manager 네트워크의 경우 초당 2개로 제한하거나
Ad Manager 360 네트워크의 경우 초당 8개로 제한합니다. 이번에도 이렇게 한다고 해서 모든 요청이 성공한다고 보장할 수는 없지만 이 오류가 발생하는 횟수를 줄이는 데 도움이 될 수 있습니다. 야간 보고서 실행과 같이 실시간 상호작용이 없는
Ad Manager와 통합되는 애플리케이션에 사용하는 것이 좋습니다.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- 요약
- 사용자가 이미 네트워크에 연결된 계정을 사용하여 테스트 네트워크를 만들려고 했습니다.
- 일반적인 원인
- 사용자가
NetworkService.makeTestNetwork()를 호출하기 전에 먼저 새 Google 계정을 만들지 않았습니다.
- 권장 해결 방법
NetworkService.makeTestNetwork()를 호출하기 전에 새 계정을 만드세요. 자세한 내용은 테스트 네트워크를 만드는 방법을 참조하세요.
AuthenticationError.NETWORK_CODE_REQUIRED
- 요약
- 사용자가
networkCode를 제공하지 않았습니다. 요청하려면 네트워크 코드가 필요합니다.
- 일반적인 원인
NetworkService.getAllNetworks() 및 NetworkService.makeTestNetwork()를 제외한 모든 요청에 네트워크 코드가 필요합니다.- 권장 해결 방법
- 요청 헤더에 주소를 지정할 네트워크의 네트워크 코드를 포함합니다. 계정 로그인에 사용할 수 있는 네트워크 코드만 사용하세요. Ad Manager 웹사이트의
관리 > 네트워크 설정 페이지에서 '네트워크 코드' 옆에 있는
코드를 확인할 수 있습니다. 네트워크 코드 설정에 관한 자세한 내용은 SOAP XML 요청 및 응답 헤더 페이지를 참조하세요.
AuthenticationError.NETWORK_NOT_FOUND
- 요약
- 구성에 제공된 네트워크 코드를 서버에서 찾을 수 없어 요청을 수행할 수 없습니다.
- 일반적인 원인
- 구성에서 잘못된 네트워크 코드를 지정했습니다.
- 권장 해결 방법
- 오류 로그의 'trigger' 필드는 사용자에게 적합한 네트워크를 제안하는 경우가 많습니다.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- 요약
- 사용자가 네트워크에 연결되어 있지 않습니다.
- 일반적인 원인
- API 액세스용으로 프로덕션 계정을 사용 설정하지 않았습니다.
- 권장 해결 방법
- 프로덕션 환경에 대한 API 액세스를 사용 설정합니다. 자세한 내용은 API 액세스 사용 설정을 참조하세요.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- 요약
- 고객이 API 액세스 허용 목록에 없습니다.
- 일반적인 원인
- 네트워크가 프로덕션 허용 목록에 포함되어 있지 않지만 SOAP 헤더에 네트워크 코드를 입력하셨습니다.
-
- 권장 해결 방법
- API 액세스를 사용 설정합니다.
-
PermissionError.PERMISSION_DENIED
- 요약
- 사용자에게 요청에 필요한 권한이 없습니다.
- 일반적인 원인
-
- 다른 네트워크에 있는 객체에 액세스하려고 했습니다.
- 네트워크에 있는 객체에 액세스하려고 했지만 읽거나 업데이트할 권한이 없습니다.
- 계정에서 추가 기능을 사용 설정해야 하는 작업을 수행하려고 했습니다.
- 권장 해결 방법
-
- UI를 만드는 경우 사용자에게 이 작업을 실행할 권한이 없다고 알리고 관리자에게 문의하도록 안내합니다.
- 네트워크에 권한이 없는 프리미엄 전용 기능과 관련된 작업과 같은 작업을 실행하려고 했다면 계정 관리자에게 이 기능을 사용 설정하는 방법을 문의하세요.
- 기본적으로 테스트 네트워크는 Ad Manager 360 네트워크가 아니며,
Ad Manager 360 네트워크에는 프리미엄 기능이 없습니다. 계정 관리자에게 문의하여 테스트 네트워크에서 기능을 사용 설정하세요.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- 요약
- 애플리케이션이 성공하려면 최신 버전이 필요한 요청을 시작했거나 지원 중단된 버전으로 요청을 시작했습니다.
- 일반적인 원인
-
- API 호출 버전이 지원 중단되었습니다. 지원 중단 공지사항을 확인하려면 블로그를 구독하세요.
- 요청을 처리하려면 최신 버전의 API가 필요합니다.
일반적으로 UI에 기능이 도입되며 API가 객체를 올바르게 전송하려면 최신 버전의 API가 필요합니다.
- 권장 해결 방법
-
- API 버전에 대한 최신 정보를 얻고, 정기적으로 업그레이드할 계획을 세우세요.
- 지원 중단에 대한 알림을 받으려면 Google 블로그를 구독하세요.
404 오류
- 요약
- 요청이 서버에 도달하지 못했습니다.
- 일반적인 원인
- 인터넷 연결 또는 프록시가 잘못 구성되었을 수 있습니다. 호출 중인 API 버전도 지원 중단될 수 있습니다.
-
- 권장 해결 방법
- 인터넷 또는 프록시 구성을 확인하고 최신 버전의 API를 사용 중인지 확인하세요. 클라이언트 라이브러리를 최신 버전으로 업그레이드하는 것이 좋습니다.
-
- 예방법
- Ad Manager API 포럼을 구독하고 Google 블로그에서 최신 Ad Manager API 소식을 확인하세요.
언마셜링 오류
- 요약
- 요청의 SOAP XML이 WSDL 사양을 준수하지 않습니다.
- 일반적인 원인
- 요청에 WSDL 사양에 포함되지 않았거나 잘못된 네임스페이스에 있는 필드 또는 항목이 있습니다.
-
- 요청에 유형이 일치하지 않습니다 (예: 정수 필드에 문자열 값이 있음).
-
- 권장 해결 방법
- 요청이 WSDL 사양을 준수하는지 확인합니다.
- 클라이언트 라이브러리를 사용하여 유효한 SOAP를 생성하고 비교에 사용하세요. 모든 클라이언트 라이브러리는 SOAP 요청 및 응답의 로깅을 지원합니다.
-
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eThis page lists common Google Ad Manager API errors and offers troubleshooting tips.\u003c/p\u003e\n"],["\u003cp\u003eErrors are categorized by type, such as authentication, permission, and quota errors.\u003c/p\u003e\n"],["\u003cp\u003eEach error description includes a summary, common causes, and recommended handling tips.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to stay updated on API versions and subscribe to the Ad Manager API forum and blog for the latest news.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing client libraries for generating valid SOAP requests is recommended to avoid unmarshalling errors.\u003c/p\u003e\n"]]],[],null,["# Common Errors\n\nThis page describes the most frequently encountered errors returned by the\nGoogle Ad Manager API. Errors are returned in the format\n`Error.REASON`:\n\n- [`EntityChildrenLimitReachedError`](#EntityChildrenLimitReachedError)\n- [`QuotaError.EXCEEDED_QUOTA`](#QuotaError.EXCEEDED_QUOTA)\n- [`AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`](#AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK)\n- [`AuthenticationError.NETWORK_CODE_REQUIRED`](#AuthenticationError.NETWORK_CODE_REQUIRED)\n- [`AuthenticationError.NETWORK_NOT_FOUND`](#AuthenticationError.NETWORK_NOT_FOUND)\n- [`AuthenticationError.NO_NETWORKS_TO_ACCESS`](#AuthenticationError.NO_NETWORKS_TO_ACCESS)\n- [`AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`](#AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS)\n- [`PermissionError.PERMISSION_DENIED`](#PermissionError.PERMISSION_DENIED)\n- [`ApiVersionError.UPDATE_TO_NEWER_VERSION`](#ApiVersionError.UPDATE_TO_NEWER_VERSION)\n- [404 Error](#404Error)\n- [Unmarshalling Errors](#Unmarshalling)\n\n[Entity limit errors](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError)\n-------------------------------------------------------------------------------------------------------\n\n### `EntityChildrenLimitReachedError`\n\nSummary\n: The maximum number of allowed children has been reached for the entity\n and no more children can be added to that entity.\n\nRecommended handling tips\n: Create a new type of the entity that has reached the max allowed number\n of children and add the child entity you are trying to create to the new one.\n For example if you receive [LINE_ITEM_LIMIT_FOR_ORDER_REACHED](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError.Reason#LINE_ITEM_LIMIT_FOR_ORDER_REACHED),\n then you will need to create a new order and add the line item you are trying\n to create to that new order.\n\n[Quota errors](/ad-manager/api/reference/latest/NetworkService.QuotaError)\n--------------------------------------------------------------------------\n\n### `QuotaError.EXCEEDED_QUOTA`\n\nSummary\n: The number of requests made per second is too high and has exceeded the\n allowable limit.\n\nRecommended handling tips\n:\n - Use batch methods such as [updateLineItems](/ad-manager/api/reference/latest/LineItemService#updateLineItems) by gathering changes locally and making a single request to fulfill those changes all at once.\n - Wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. This is recommended for interactive applications integrating with Ad Manager that are used in real time.\n - Limit requests to 2 per second for Ad Manager networks, or 8 per second for Ad Manager 360 networks. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. This is recommended for applications integrating with Ad Manager that do not have real time interaction, such as running nightly reports.\n\n[Authentication errors](/ad-manager/api/reference/latest/NetworkService.AuthenticationError)\n--------------------------------------------------------------------------------------------\n\n### `AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`\n\nSummary\n: The user tried to create a test network using an account that already is\n associated with a network.\n\nCommon causes\n: The user did not create a new Google account first before calling\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Create a brand new account before calling\n `NetworkService.makeTestNetwork()`. See [how to create a test network](/ad-manager/api/start#enable_api) for more\n information.\n\n### `AuthenticationError.NETWORK_CODE_REQUIRED`\n\nSummary\n: The user did not provide a `networkCode`. To make the request,\n a network code is required.\n\nCommon causes\n: Network codes are required for all requests except\n `NetworkService.getAllNetworks()` and\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Include the network code of the network being addressed in the request\n header. Only use a network code available to your account login. You can find\n the code on the Ad Manager website for your account, on the Admin \\\u003e Network\n Settings page next to \"Network code\". More information about setting your\n network code can be found on the [SOAP XML request and\n response headers](/ad-manager/api/soap_xml) page.\n\n### `AuthenticationError.NETWORK_NOT_FOUND`\n\nSummary\n: The request could not be made because the network code provided in the\n configuration is not found on the server.\n\nCommon causes\n: You have specified an incorrect network code in your configuration.\n\nRecommended handling tips\n: The \"trigger\" field of the error log will often suggest the correct\n network for the user.\n\n### `AuthenticationError.NO_NETWORKS_TO_ACCESS`\n\nSummary\n: The user is not associated with any network.\n\nCommon causes\n: You have not enabled your production account for API access.\n\nRecommended handling tips\n: Enable API access to your production environment. See [Enabling API Access](/ad-manager/api/start#enable_api) for information.\n\n### `AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`\n\nSummary\n: The customer is not whitelisted for API access.\n\nCommon causes\n: Your network is not whitelisted for production, but you provided a [network code](/ad-manager/api/soap_xml) in the SOAP Header.\n:\n\nRecommended handling tips\n: Enable [API access](/ad-manager/api/start#enable_api).\n:\n\n[Permission errors](/ad-manager/api/reference/latest/NetworkService.PermissionError)\n------------------------------------------------------------------------------------\n\n### `PermissionError.PERMISSION_DENIED`\n\nSummary\n: The user does not have the required permission for the request.\n\nCommon causes\n:\n - You tried to access an object that exists in another network.\n - You tried to access an object that exists in your network, but you don't have permission to read or update.\n - You tried to perform a task that requires an additional feature to enabled on your account.\n\nRecommended handling tips\n:\n - If you are creating a UI, indicate to the user that they did not have permission to perform this action and to speak to their Administrator.\n - If you tried performing a task, such as one involving a premium-only feature that your network does not have permission to do, speak to your account manager about enabling this feature.\n - Remember, test networks are, by default, not Ad Manager 360 networks, meaning that they do not have the premium features found in Ad Manager 360 networks. Speak to your account manager to enable features on your test network.\n\n[Version errors](/ad-manager/api/reference/latest/NetworkService.ApiVersionError)\n---------------------------------------------------------------------------------\n\n### `ApiVersionError.UPDATE_TO_NEWER_VERSION`\n\nSummary\n: The application either: initiated a request that requires a newer version\n to succeed; or initiated a request to a deprecated version.\n\nCommon causes\n:\n - The version of the API call has been deprecated. Please subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) for deprecation announcements.\n - The request you made requires a newer version of the API to succeed. This is often the case where a feature has been introduced in the UI and in order for the API to send the object correctly, it needs a newer version of the API.\n\nRecommended handling tips\n:\n - Stay up to date on API versions; plan on upgrading regularly.\n - Subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) to be notified about deprecations.\n\n404 Error\n---------\n\nSummary\n: Your request did not reach the server.\n\nCommon causes\n: Your internet connection or proxy may be misconfigured. The version of\n the API you are calling may also be sunsetted.\n:\n\nRecommended handling tips\n: Check your internet or proxy configuration and make sure you are using a\n recent version of the API. You may want to upgrade your client library to\n the most recent version as well.\n:\n\nPrevention tips\n: Subscribe to the [Ad\n Manager API forum](//groups.google.com/group/google-doubleclick-for-publishers-api) and check our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api)\n to stay updated on the latest Ad Manager API news.\n\nUnmarshalling Error\n-------------------\n\nSummary\n: The SOAP XML in your request did not conform to the WSDL\n specification.\n\nCommon causes\n: The request contains fields or entities not included in the WSDL\n specification, or in the wrong namespace.\n:\n: There is a type mismatch in the request (e.g., an integer field has a\n string value).\n:\n\nRecommended handling tips\n: Ensure that your request conforms to the WSDL specification.\n:\n: Use a [client library](/ad-manager/api/clients) to generate\n valid SOAP, and use this for comparison. All client libraries support\n logging of SOAP requests and responses.\n:"]]
