이 페이지에서는 Google Ad Manager API에서 가장 자주 발생하는 오류를 설명합니다. 오류는 Error.REASON
형식으로 반환됩니다.
-
EntityChildrenLimitReachedError
-
QuotaError.EXCEEDED_QUOTA
-
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
-
AuthenticationError.NETWORK_CODE_REQUIRED
-
AuthenticationError.NETWORK_NOT_FOUND
-
AuthenticationError.NO_NETWORKS_TO_ACCESS
-
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
-
PermissionError.PERMISSION_DENIED
-
ApiVersionError.UPDATE_TO_NEWER_VERSION
- 404 오류
- 마샬링 취소 오류
항목 한도 오류
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 요청 및 응답의 로깅을 지원합니다.