제공된 액세스 토큰에 Google Ads API OAuth 2.0 범위가 포함되어 있지 않으므로 요청이 거부됩니다.
대응 방법
액세스 토큰에 필요한 범위가 있는지 확인합니다. 이 오류가 발생하는 일반적인 이유는 다른 OAuth 범위 집합을 사용하여 생성된 기존 액세스 토큰을 재사용하기 때문입니다. 필수 범위로 새 액세스 토큰을 생성하는 방법의 예는 OAuth 승인 매개변수를 참고하세요.
예방법
액세스 토큰에 필요한 범위가 있는지 확인합니다. 필요한 범위로 사용자를 다시 인증하여 필요한 범위의 액세스 권한을 얻습니다. 애플리케이션에서 여러 OAuth 범위를 사용하는 경우 세분화된 OAuth 권한을 구현해야 할 수 있습니다.
google.auth.exceptions.RefreshError
invalid_grant
요약
토큰이 만료되었거나 취소되었습니다.
일반적인 원인
외부 사용자 유형 및 게시 상태가 Testing인 OAuth 동의 화면이 구성된 Google Cloud Platform 프로젝트에는 7일 후에 만료되는 갱신 토큰이 발급됩니다.
대응 방법
Google 프로젝트의 게시 상태가 Testing이므로 갱신 토큰이 7일마다 만료되고 invalid_grant 오류가 발생합니다. Google API 콘솔로 이동하여 OAuth 동의 화면으로 이동합니다. 그런 다음 게시 상태를 In production로 변경하여 갱신 토큰이 7일 후에 만료되지 않도록 합니다.
단일 요청의 두 작업에 동일한 바이너리 데이터가 있는 애셋의 생성 작업이 포함되어 있습니다.
일반적인 원인
동일한 바이너리 데이터가 포함된 중복된 생성 작업이 있는 mutate 요청입니다.
대응 방법
별도의 요청에서 확장 소재를 만든 다음 후속 요청에서 확장 소재에 연결하거나 동일한 요청 내에서 임시 ID를 사용합니다.
예방법
해당 사항 없음
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
요약
파트너 프로모션 ID가 계정의 프로모션 통합에서 허용하지 않는 oneof 변형 (int_value 또는 string_value)을 사용합니다.
일반적인 원인
고객의 사용 통합에 string_value 변형이 필요한 경우 promotion_asset.external_redeem_info.partner_promotion_id.int_value 필드를 설정하거나 통합에 int_value 변형이 필요한 경우 string_value 필드를 설정합니다.
123-456-7890은 1234567890이어야 합니다. 자세한 내용은 시작하기를 참고하세요.
CLIENT_CUSTOMER_ID_IS_REQUIRED
요약
HTTP 헤더에 클라이언트 고객 ID가 지정되지 않았습니다.
일반적인 원인
HTTP 헤더에 클라이언트 고객 ID를 지정하지 않음
대응 방법
해당 사항 없음
예방법
모든 호출에는 클라이언트 고객 ID가 필요하므로 HTTP 헤더에 지정했는지 확인하세요. 이 작업을 처리하는 클라이언트 라이브러리를 사용하는 것이 좋습니다.
CUSTOMER_NOT_FOUND
요약
헤더에 제공된 고객 ID에 해당하는 계정을 찾을 수 없습니다.
일반적인 원인
백엔드에서 계정이 생성되기 전에 방금 생성된 계정에 액세스하려고 시도하는 경우
대응 방법
처음에는 5분 동안 기다린 후 30초마다 다시 시도합니다.
예방법
계정이 생성된 후 몇 분 정도 기다렸다가 요청을 실행하세요.
GOOGLE_ACCOUNT_COOKIE_INVALID
요약
요청 헤더의 액세스 토큰이 잘못되었거나 만료되었습니다.
일반적인 원인
액세스 토큰이 무효화되었습니다.
대응 방법
새 토큰을 요청합니다. 클라이언트 라이브러리 중 하나를 사용하는 경우 토큰을 새로고침하는 방법에 관한 문서를 참고하세요.
예방법
액세스 토큰이 만료될 때까지 저장하고 재사용합니다.
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 헤더와 함께 전달된 액세스 토큰이 올바르지 않습니다.
대응 방법
해당 사항 없음
예방법
계정과 연결된 올바른 액세스 토큰을 전달했는지 확인하세요. 갱신 토큰 및 승인 코드와 혼동되는 경우가 있습니다. 관리자 계정의 모든 고객 계정에 액세스할 수 있는 사용자 인증 정보를 가져오려면 관리자 계정의 갱신 토큰을 가져와야 합니다. 사용자 인증 가이드를 참고하세요.
Google Cloud 프로젝트에 테스트 액세스 권한만 있으며 프로덕션 계정에 액세스하는 데 사용할 수 없습니다.
일반적인 원인
테스트 액세스 수준이 있는 Google Cloud 프로젝트를 사용하여 테스트가 아닌 (프로덕션) Google Ads 계정에 요청을 보냈습니다. (API 버전 v24 이하에서는 이 조건이 AuthorizationError.ACTION_NOT_PERMITTED를 반환합니다.)
캠페인이 추가되거나 이름이 변경되고 있지만, 해당 이름이 이미 다른 캠페인에서 사용 중입니다.
일반적인 원인
기존의 활성 또는 일시중지된 캠페인의 이름으로 새 캠페인을 만듭니다.
대응 방법
오류를 기록하고 사용자에게 오류 메시지를 표시합니다. 원하는 경우 고유한 캠페인 이름을 제안하거나 사용 중인 이름 목록을 표시합니다.
예방법
해당 사항 없음
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
요약
AI Max가 사용 설정된 캠페인에서 캠페인 수준 키워드 검색 유형 설정을 변경하려고 합니다.
일반적인 원인
AI Max를 사용 설정하면 모든 키워드가 기본적으로 확장검색으로 취급되므로 캠페인 수준 확장검색 설정이 지원 중단됩니다. 이 필드를 설정하거나 수정하려고 하면 오류가 발생합니다.
대응 방법
사용자에게 캠페인 수준에서 확장검색을 설정하는 대신 광고 그룹 수준의 `disable_search_term_matching` 매개변수를 사용하도록 안내합니다.
예방법
`ai_max_setting.enable_ai_max` 가 `true`로 설정된 경우 캠페인에서 `keyword_match_type` 을 `BROAD` (또는 다른 값)로 설정하지 마세요. `disable_search_term_matching`을 사용하여 광고 그룹 수준에서 검색어 일치를 전환합니다.
이전된 디맨드젠 캠페인은 원본 캠페인이 삭제되기 전이나 동일한 원본 캠페인에 대해 이전된 다른 캠페인이 이미 활성화되어 있는 동안에는 활성화할 수 없습니다.
일반적인 원인
기존 소스 캠페인이 삭제되지 않았거나 동일한 기존 캠페인에서 이전된 다른 디맨드젠 캠페인이 이미 ENABLED인 경우 이전된 디맨드젠 캠페인의 status를 ENABLED로 업데이트합니다. API 버전 v25 이하에서 이 조건은 RequestError.UNKNOWN를 반환합니다.
대응 방법
이전된 디맨드젠 캠페인을 활성화하기 전에 CampaignOperation.remove를 사용하여 기존 소스 캠페인을 삭제하고(사전 또는 동일한 mutate 요청에서) 동일한 기존 캠페인에서 이전된 다른 디맨드젠 캠페인이 활성화되어 있지 않은지 확인합니다. 자세한 내용은 이전된 캠페인 활성화하기를 참고하세요.
예방법
기존 소스 캠페인과 이전된 디맨드젠 캠페인의 ID를 추적하는 경우 이전된 캠페인에서 status를 ENABLED로 설정하기 전에 campaign.status를 쿼리하거나 동일한 mutate 요청에 기존 캠페인의 CampaignOperation.remove를 포함하세요.
이 오류는 요청하는 애플리케이션에 대한 액세스 권한이 이미 부여된 사용자의 갱신 토큰을 생성하려고 할 때 발생합니다. 예를 들어 동일한 OAuth 클라이언트 사용자 인증 정보 및 승인 사용자에 대해 사용자 인증 정보 생성 예시를 두 번 이상 실행할 때 이 문제가 발생할 수 있습니다.
대응 방법
승인 사용자 및 OAuth 클라이언트 사용자 인증 정보의 특정 조합에 대한 갱신 토큰을 다시 생성하려면 기존 갱신 토큰을 취소합니다. 토큰을 취소하면 Google Ads API 액세스에 사용할 수 없게 되며 갱신 토큰을 사용하여 생성된 액세스 토큰이 무효화됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-10-30(UTC)"],[],[]]
