이 페이지에서는 일반적인 오류에 대해 설명하고 이러한 오류를 예방하고 처리하는 방법에 대한 도움말을 제공합니다.
전체 오류 목록은 오류 참조를 확인하세요. 추가 지원이 필요하면 포럼을 방문하세요.
google.auth.exceptions.RefreshError
|
invalid_grant |
요약 | 토큰이 만료되었거나 취소되었습니다. |
일반적인 원인 |
외부 사용자 유형에 맞게 OAuth 동의 화면이 구성되고 게시 상태가 Testing 인 Google Cloud Platform 프로젝트에는 7일 후에 만료되는 갱신 토큰이 발급됩니다.
|
처리 방법 |
Google 프로젝트의 게시 상태가 Testing 이므로 갱신 토큰이 7일마다 만료되고 invalid_grant 오류가 발생합니다. Google API 콘솔로 이동하여 OAuth 동의 화면으로 이동합니다. 그런 다음 갱신 토큰이 7일 후에 만료되지 않도록 다음 안내에 따라 게시 상태를 In production 로 변경하세요.
|
예방법 |
인증되지 않은 앱을 참고하세요.
|
|
|
CLIENT_CUSTOMER_ID_INVALID |
요약 | 클라이언트 고객 ID가 숫자가 아닙니다. |
일반적인 원인 |
부적절한 클라이언트 고객 ID를 사용합니다.
|
처리 방법 |
해당 사항 없음
|
예방법 |
123-456-7890은 1234567890이어야 합니다. 자세한 내용은 시작하기를 참고하세요.
|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
요약 | 클라이언트 고객 ID가 HTTP 헤더에 지정되지 않았습니다. |
일반적인 원인 |
HTTP 헤더에 클라이언트 고객 ID를 지정하지 않습니다.
|
처리 방법 |
해당 사항 없음
|
예방법 |
클라이언트 고객 ID는 모든 호출에 필요하므로 HTTP 헤더에 클라이언트 ID를 지정해야 합니다. 이 작업을 대신 처리해 주는 클라이언트 라이브러리를 사용해 보세요.
|
|
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 헤더로 전달된 액세스 토큰이 올바르지 않습니다.
|
처리 방법 |
해당 사항 없음
|
예방법 |
계정과 연결된 올바른 액세스 토큰을 전달했는지 확인하세요. 갱신 토큰 및 승인 코드와 혼동되기도 합니다. 관리자 계정의 모든 고객 계정에 액세스할 수 있는 사용자 인증 정보를 가져오려면 관리자 계정의 갱신 토큰을 가져와야 합니다. 자세한 내용은 액세스 토큰 및 갱신 토큰과 OAuth2에 관한 가이드를 참고하세요.
|
|
|
CUSTOMER_NOT_ENABLED |
요약 | 사용 설정된 상태가 아니므로 고객 계정에 액세스할 수 없습니다. |
일반적인 원인 |
고객 계정이 가입을 완료하지 않았거나 비활성화된 경우 이러한 상황이 발생합니다.
|
처리 방법 |
Google Ads UI에 로그인하고 이 계정에 대한 가입 절차를 완료했는지 확인합니다. 비활성화된 계정은 해지된 Google Ads 계정 재활성화를 참조하세요.
|
예방법 |
CANCELLED 상태를 확인하여 고객 계정이 비활성화되었는지 사전에 확인할 수 있습니다.
|
|
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 을 지정하지 않습니다.
|
처리 방법 |
해당 사항 없음
|
예방법 |
하이픈 (- ) 없이 관리자 계정 ID로 login-customer-id 를 지정합니다. 클라이언트 라이브러리에서는 이를 기본적으로 지원합니다.
|
|