일반적인 오류

이 페이지에서는 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 요청 및 응답의 로깅을 지원합니다.