일반적인 오류

이 페이지에서는 일반적인 오류를 설명하고 오류를 예방하고 처리하는 팁을 제공합니다. 전체 오류 목록은 오류 참조를 확인하세요. 추가 지원이 필요하면 포럼을 방문하세요.

google.auth.exceptions.RefreshError

invalid_grant
요약토큰이 만료되었거나 취소되었습니다.
일반적인 원인 외부 사용자 유형에 대해 OAuth 동의 화면이 구성되어 있고 게시 상태가 Testing인 Google Cloud Platform 프로젝트에는 7일 후에 만료되는 갱신 토큰이 발급됩니다.
처리 방법 Google 프로젝트의 게시 상태가 Testing이므로 갱신 토큰이 7일마다 만료되고 invalid_grant 오류가 발생합니다. Google API 콘솔로 이동하여 OAuth 동의 화면으로 이동합니다. 그런 다음 갱신 토큰이 7일 후에 만료되지 않도록 안내에 따라 게시 상태를 In production로 변경하세요.
예방법 인증되지 않은 앱을 참고하세요.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
요약이 연산자는 Ad의 서브클래스와 함께 사용할 수 없습니다.
일반적인 원인 광고의 status 외의 속성을 수정하려고 시도했습니다.
처리 방법 해당 사항 없음
예방법 광고를 만든 후에는 수정할 수 없습니다. 광고를 수정하려면 새 광고를 만든 후 기존 광고를 삭제해야 합니다. 그러나 광고의 statusMutateAdGroupAds를 사용하여 수정할 수 있습니다.
INVALID_INPUT
요약광고의 필드 중 하나에 잘못된 문자가 포함되어 있습니다.
일반적인 원인 URL에 특수문자 사용
처리 방법 해당 사항 없음
예방법 API 요청을 하기 전에 앱에서 URL의 유효성을 검사합니다.
LINE_TOO_WIDE
요약광고의 입력란 중 하나가 최대 허용 길이를 초과했습니다. 텍스트 광고에 대한 정보를 참고하세요.
일반적인 원인 텍스트가 너무 긴 경우
처리 방법 해당 사항 없음
예방법 API 요청을 하기 전에 줄 길이를 검사합니다.

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS
요약일부 광고에서 이미 이 라벨을 사용하고 있습니다.
일반적인 원인 라벨을 이미 연결된 광고와 연결하려고 합니다.
처리 방법 해당 사항 없음
예방법 추가할 라벨이 이미 광고와 연결되어 있는지 먼저 확인하세요.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD
요약삭제된 광고에 대한 업데이트 작업을 시도했습니다.
일반적인 원인 삭제된 광고는 더 이상 업데이트할 수 없으며 상태 변경도 불가능합니다.
처리 방법 해당 사항 없음
예방법 삭제된 광고를 업데이트하려는 코드가 없는지 확인합니다.

AdGroupCriterionError

INVALID_KEYWORD_TEXT
요약키워드에 잘못된 문자가 포함되어 있습니다. 키워드 추가하기를 참고하세요.
일반적인 원인 키워드에 잘못된 문자가 포함되어 있습니다.
처리 방법 해당 사항 없음
예방법 API에 요청하기 전에 앱에서 키워드 텍스트의 유효성을 검사합니다.

AdGroupError

DUPLICATE_ADGROUP_NAME
요약추가 또는 이름을 변경하려는 광고그룹의 이름이 이미 다른 광고그룹에서 사용 중입니다.
일반적인 원인 운영 중이거나 일시중지된 기존 광고그룹의 이름으로 새 광고그룹을 만듭니다.
처리 방법 오류를 기록하고 사용자에게 오류 메시지를 표시합니다. 원하는 경우 고유한 광고그룹 이름을 제안하거나 사용 중인 이름을 표시할 수도 있습니다.
예방법 해당 사항 없음

AssetError

DUPLICATE_ASSET
요약단일 요청의 두 연산에는 동일한 바이너리 데이터를 가진 저작물에 대한 생성 연산이 포함됩니다.
일반적인 원인 동일한 바이너리 데이터를 포함하는 중복된 생성 연산이 있는 뮤테이션 요청입니다.
처리 방법 별도의 요청에서 저작물을 만든 후 후속 요청에서 저작물을 연결하거나 동일한 요청에서 임시 ID를 사용합니다.
예방법 해당 사항 없음

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
요약클라이언트 고객 ID가 숫자가 아닙니다.
일반적인 원인 잘못된 클라이언트 고객 ID 사용
처리 방법 해당 사항 없음
예방법 123-456-7890은 1234567890이어야 합니다. 자세한 내용은 시작하기를 참고하세요.
CLIENT_CUSTOMER_ID_IS_REQUIRED
요약HTTP 헤더에 클라이언트 고객 ID가 지정되지 않았습니다.
일반적인 원인 HTTP 헤더에 클라이언트 고객 ID를 지정하지 않습니다.
처리 방법 해당 사항 없음
예방법 클라이언트 고객 ID는 모든 호출에 필요하므로 HTTP 헤더에 지정해야 합니다. 이 작업은 Google의 클라이언트 라이브러리에서 처리하므로 사용해 보시기 바랍니다.
CUSTOMER_NOT_FOUND
요약헤더에 제공된 고객 ID에 해당하는 계정이 없습니다.
일반적인 원인 백엔드에서 계정이 설정되기 전에 방금 만든 계정에 액세스를 시도했습니다.
처리 방법 5분간 기다린 다음 30초마다 다시 시도합니다.
예방법 계정 생성 후 몇 분 정도 기다린 후 계정에 요청을 전송합니다.
요약요청 헤더의 액세스 토큰이 잘못되었거나 만료되었습니다.
일반적인 원인 액세스 토큰이 무효화되었습니다.
처리 방법 새 토큰을 요청합니다. 클라이언트 라이브러리 중 하나를 사용 중인 경우 해당 문서에서 토큰을 갱신하는 방법을 참조하세요.
예방법 만료될 때까지 액세스 토큰을 저장하고 재사용하세요.
NOT_ADS_USER
요약액세스 토큰을 생성하는 데 사용된 Google 계정이 Google Ads 계정과 연결되어 있지 않습니다.
일반적인 원인 입력하신 로그인 정보는 Google Ads가 활성화되지 않은 Google 계정과 일치합니다.
처리 방법 OAuth 과정을 진행하려면 유효한 Google Ads 계정 (일반적으로 관리자 계정)으로 로그인해야 합니다. 관리자 계정에 로그인한 후 문제가 되는 고객 또는 관리자 계정을 선택하고 Tools and Settings > Access and security 페이지로 이동한 다음 Google 계정 이메일 주소를 추가하여 Google 계정을 초대하여 기존 Google Ads 계정에 액세스하도록 할 수도 있습니다.
예방법 해당 사항 없음
OAUTH_TOKEN_INVALID
요약헤더의 OAuth 액세스 토큰이 잘못되었습니다.
일반적인 원인 HTTP 헤더로 전달된 액세스 토큰이 올바르지 않습니다.
처리 방법 해당 사항 없음
예방법 계정과 연결된 올바른 액세스 토큰을 전달했는지 확인하세요. 이는 갱신 토큰 및 승인 코드와 혼동되기도 합니다. 관리자 계정에 속한 모든 고객 계정에 액세스할 수 있는 사용자 인증 정보를 얻으려면 관리자 계정에 대한 갱신 토큰을 받아야 합니다. 자세한 내용은 액세스 토큰 및 갱신 토큰OAuth2에 관한 가이드를 참고하세요.

AuthorizationError

CUSTOMER_NOT_ENABLED
요약사용 설정된 상태가 아니므로 고객 계정에 액세스할 수 없습니다.
일반적인 원인 고객 계정이 가입이 완료되지 않았거나 비활성화되었을 때 발생합니다.
처리 방법 Google Ads UI에 로그인하고 이 계정에 대한 가입 절차를 완료했는지 확인하세요. 비활성화된 계정의 경우 해지된 Google Ads 계정 재활성화를 참조하세요.
예방법 취소됨 상태를 확인하면 고객 계정이 비활성화되었는지 사전에 확인할 수 있습니다.
DEVELOPER_TOKEN_NOT_APPROVED
요약개발자 토큰은 테스트 계정에서만 사용하도록 승인되었으며 테스트 이외의 계정에 액세스를 시도했습니다.
일반적인 원인 테스트 개발자 토큰이 테스트 이외의 계정에 액세스하는 데 사용되었습니다.
처리 방법 실제로 테스트용이 아닌 계정에 액세스하려는 것인지 확인합니다. 이 경우 일반 또는 기본 액세스로 개발자 토큰 업그레이드를 신청해야 합니다.
예방법 해당 사항 없음
DEVELOPER_TOKEN_PROHIBITED
요약요청에 전송된 프로젝트에는 개발자 토큰이 허용되지 않습니다.
일반적인 원인 각 Google API 콘솔 프로젝트는 하나의 관리자 계정의 개발자 토큰과만 연결할 수 있습니다. Google Ads API 요청을 하면 개발자 토큰이 Google API 콘솔 프로젝트와 영구적으로 페어링됩니다. 새 Google API 콘솔 프로젝트를 사용하지 않으면 요청할 때 DEVELOPER_TOKEN_PROHIBITED 오류가 발생합니다.
처리 방법 해당 사항 없음
예방법 새 관리자 계정에서 개발자 토큰으로 전환하는 경우 새 관리자의 토큰을 사용하는 Google Ads API 요청을 위한 새 Google API 콘솔 프로젝트를 생성해야 합니다.
USER_PERMISSION_DENIED
요약승인된 고객이 운영 고객에 대한 액세스 권한이 없습니다.
일반적인 원인 관리자 계정에 대한 액세스 권한이 있는 사용자로 인증하지만 요청에 login-customer-id를 지정하지 않습니다.
처리 방법 해당 사항 없음
예방법 login-customer-id을(를) 하이픈 없이 관리자 계정 ID(-)로 지정합니다. 클라이언트 라이브러리에서 이를 기본적으로 지원합니다.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS
요약입찰가가 계정 통화 최소 단위의 배수가 아닙니다. 예를 들어 0.015달러 (마이크로 단위 15000)는 유효한 입찰가가 아닙니다.
일반적인 원인 해당 사항 없음
처리 방법 해당 사항 없음
예방법 입찰가가 계정 통화의 최소 단위의 배수인지 확인합니다.
BID_TOO_BIG
요약입찰가가 캠페인 예산 내에 있어도 오류가 반환됩니다.
일반적인 원인 해당 사항 없음
처리 방법 해당 사항 없음
예방법 계정이 Google Ad Grants에 참여하고 있는지 확인합니다. 그렇다면 CPC 입찰가를 프로그램에서 정한 최대값으로 제한하세요.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
요약예산 금액이 너무 작습니다.
일반적인 원인 해당 사항 없음
처리 방법 해당 사항 없음
예방법 예산 금액이 계정 통화의 최소 단위보다 크거나 같은지 확인합니다.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
요약마이크로 금액을 계정 통화의 금액으로 변환하면 예산 금액이 소수점 이하 자릿수가 너무 많습니다.
일반적인 원인 해당 사항 없음
처리 방법 해당 사항 없음
예방법 예산 금액을 계정 통화의 최소 단위로 나눌 수 있는지 확인합니다.

CampaignError

DUPLICATE_CAMPAIGN_NAME
요약추가 또는 이름을 변경하려는 캠페인의 이름이 이미 다른 캠페인에서 사용되고 있습니다.
일반적인 원인 운영 중이거나 일시중지된 기존 캠페인의 이름으로 새 캠페인을 만듭니다.
처리 방법 오류를 기록하고 사용자에게 오류 메시지를 표시합니다. 원하는 경우 고유한 캠페인 이름을 제안하거나 사용 중인 이름 목록을 표시할 수도 있습니다.
예방법 해당 사항 없음

CriterionError

KEYWORD_HAS_INVALID_CHARS
요약잘못된 문자가 포함된 키워드를 추가하거나 수정합니다.
일반적인 원인 키워드에 특수문자(예: ! @ % *)를 사용합니다.
처리 방법 해당 사항 없음
예방법 키워드에 사용할 수 없는 문자를 사용하지 않도록 합니다. 키워드 추가하기를 참고하세요.

DistinctError

DUPLICATE_ELEMENT
요약요청에 동일한 매개변수가 중복된 두 매개변수가 포함되어 있습니다.
일반적인 원인 해당 사항 없음
처리 방법 해당 사항 없음
예방법 작업, 매개변수, 목록 요소 등에서 중복을 제거한 후 요청을 수행합니다. DistinctElements 제약 조건이 있는 필드를 찾습니다.

InternalError

DEADLINE_EXCEEDED
요약요청 시간이 초과되어 응답을 반환할 만큼 빠르게 완료할 수 없습니다.
일반적인 원인 너무 큰 응답이 생성되어 검색 요청이 생성되었거나, 변경 요청이 너무 커서 처리할 수 없습니다.
처리 방법 30초 후에 요청을 다시 시도하세요. 오류가 계속되면 더 빠르게 완료할 수 있는 여러 개의 작은 요청으로 요청을 분할해 보세요.
예방법 세분화를 검토하여 세분화가 응답 크기에 어떤 영향을 미치는지 이해합니다. gRPC 전송 계층 제한사항을 숙지합니다.
INTERNAL_ERROR
요약요청을 처리하는 중에 예상치 못한 문제가 발생했습니다.
일반적인 원인 버그로 인해 API가 올바르게 작동하지 않습니다.
처리 방법 재시도에 지수 백오프 일정을 사용하여 이 오류가 발생한 요청을 재시도합니다.
예방법 해당 사항 없음
TRANSIENT_ERROR
요약일시적인 내부 오류가 발생했습니다. 재시도를 수행해야 합니다.
일반적인 원인 이 오류는 API에 내부적으로 일시적인 문제가 발생했을 때 발생합니다.
처리 방법 재시도에 지수 백오프 일정을 사용하여 이 오류가 발생한 요청을 재시도합니다.
예방법 해당 사항 없음

InvalidGrantError

invalid_grant (malformed auth code)
요약OAuth 토큰으로 교환된 승인 코드의 형식이 잘못되었습니다.
일반적인 원인 이는 요청하는 애플리케이션에 대한 액세스 권한이 이미 부여된 사용자에 대해 갱신 토큰을 생성하려고 할 때 발생합니다. 예를 들어 동일한 OAuth 클라이언트 사용자 인증 정보와 인증 사용자에 대해 사용자 인증 정보 생성 예를 두 번 이상 실행할 때 이러한 상황이 발생할 수 있습니다.
처리 방법 승인 사용자 및 OAuth 클라이언트 사용자 인증 정보의 특정 조합에 대한 갱신 토큰을 다시 생성하려면 기존 갱신 토큰을 취소하세요. 토큰을 취소하면 Google Ads API에 액세스할 수 없으며 갱신 토큰이 생성하는 데 사용된 액세스 토큰이 무효화됩니다.
예방법 갱신 토큰을 재생성할 필요가 없도록 안전한 위치에 저장해야 합니다.

MutateError

RESOURCE_NOT_FOUND
요약요청이 찾을 수 없는 리소스를 참조했습니다.
일반적인 원인 요청이 존재하지 않거나 삭제된 리소스를 변경하거나 참조하려고 시도했습니다. 또는 리소스에 지정된 리소스 이름의 형식이 잘못되었습니다.
처리 방법 뮤테이션 요청을 제출하기 전에 검색 요청을 사용하여 기존 리소스의 리소스 이름을 검색합니다. 지원되는 모든 언어로 유효한 리소스 이름을 구성하는 방법에 대한 문서가 포함된 클라이언트 라이브러리 가이드를 검토합니다.
예방법 리소스 이름을 수동으로 만들지 마세요. 클라이언트 라이브러리에서 제공하는 도우미 메서드 중 하나를 사용합니다.

NotEmptyError

EMPTY_LIST
요약필수 목록이 비어 있습니다.
일반적인 원인 mutate 메서드에 빈 작업 목록을 전달합니다.
처리 방법 해당 사항 없음
예방법 해당 사항 없음

QuotaError

RESOURCE_EXHAUSTED
요약시스템 빈도 제한을 초과했습니다.
일반적인 원인 해당 사항 없음
처리 방법 해당 사항 없음
예방법 요청 사이에 짧은 지연을 설정하거나 더 적은 요청으로 더 많은 작업을 결합하세요.

RangeError

TOO_LOW
요약값이 허용된 최솟값보다 작습니다.
일반적인 원인 ID를 지정하지 않으면 0 값이 전달됩니다.
처리 방법 해당 사항 없음
예방법 API 참조 문서에서 범위 제한을 확인합니다.

RequestError

INVALID_INPUT
요약요청 형식이 잘못되었습니다.
일반적인 원인 요청의 URL 또는 콘텐츠 형식이 잘못되었습니다.
처리 방법 해당 사항 없음
예방법 해당 사항 없음
REQUIRED_FIELD_MISSING
요약요청에 필수 정보가 누락되었습니다.
일반적인 원인 항목을 추가할 때 필수 입력란이 누락되었습니다.
처리 방법 오류를 기록하고 사용자에게 오류 메시지를 표시합니다. 오류의 fieldPath 속성에 누락된 필드가 표시됩니다.
예방법 필요한 필드를 알아보려면 API 참조를 확인하세요.

ResourceCountLimitExceededError

RESOURCE_LIMIT
요약요청에서 리소스 생성을 시도하고 있으며, 이로 인해 해당 리소스의 총개수가 지정된 한도를 초과하게 됩니다.
일반적인 원인 특정 컨텍스트에 존재할 수 있는 리소스 수에는 여러 제한이 있습니다.
처리 방법 시스템 한도를 검토하여 발생한 한도를 확인합니다. 기존 리소스를 재사용하거나 리소스를 삭제하여 새 리소스를 위한 공간을 만드세요.
예방법 검색어를 사용하여 제한이 있는 리소스 수를 모니터링합니다.

StringLengthError

TOO_LONG
요약지정된 필드에 할당된 문자열이 한도보다 깁니다.
일반적인 원인 광고 제목 또는 설명에 텍스트가 너무 많습니다.
처리 방법 발생한 한도를 확인하고 그에 따라 문자열을 수정한 후 요청을 다시 보냅니다.
예방법 문자열 길이 제한에 유의하세요.