일반적인 오류

이 페이지에서는 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

요약
구성에서 제공된 네트워크 코드를 서버에서 찾을 수 없어 요청을 할 수 없습니다.
일반적인 원인
구성에서 잘못된 네트워크 코드를 지정했습니다.
권장 취급 요령
오류 로그의 '트리거' 필드는 사용자에게 적합한 네트워크를 제안하는 경우가 많습니다.

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 버전을 최신 상태로 유지하고 정기적으로 업그레이드하세요.
  • 블로그를 구독하여 지원 중단에 대한 알림을 받으세요.

404 오류

요약
요청이 서버에 도달하지 않았습니다.
일반적인 원인
인터넷 연결 또는 프록시가 잘못 구성되었을 수 있습니다. 호출하는 API의 버전도 지원이 종료될 수 있습니다.
권장 취급 요령
인터넷 또는 프록시 구성을 확인하고 최신 버전의 API를 사용하고 있는지 확인합니다. 클라이언트 라이브러리도 최신 버전으로 업그레이드하는 것이 좋습니다.
예방법
Ad Manager 도움말 커뮤니티와 블로그에서 최신 Ad Manager API 소식을 확인하세요.

마샬링 해제 오류

요약
요청의 SOAP XML이 WSDL 사양을 준수하지 않습니다.
일반적인 원인
요청에 WSDL 사양에 포함되지 않은 필드나 항목이 포함되어 있거나 잘못된 네임스페이스에 포함되어 있습니다.
요청에 유형 불일치가 있습니다 (예: 정수 필드에 문자열 값이 있음).
권장 취급 요령
요청이 WSDL 사양을 준수하는지 확인합니다.
클라이언트 라이브러리를 사용하여 유효한 SOAP를 생성하고 이를 비교에 사용합니다. 모든 클라이언트 라이브러리는 SOAP 요청 및 응답 로깅을 지원합니다.