이 페이지에서는 일반적인 오류를 설명하고 오류를 예방하고 처리하는 팁을 제공합니다.
전체 오류 목록은 오류 참조를 확인하세요. 추가 지원이 필요하면 포럼을 방문하세요.
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 |
| 요약 | HTTP 헤더에 클라이언트 고객 ID가 지정되지 않았습니다. |
|---|
| 일반적인 원인 |
HTTP 헤더에 클라이언트 고객 ID를 지정하지 않습니다.
|
|---|
| 처리 방법 |
해당 사항 없음
|
|---|
| 예방법 |
클라이언트 고객 ID는 모든 호출에 필요하므로 HTTP 헤더에 지정해야 합니다. 이 작업은 Google의 클라이언트 라이브러리에서 처리하므로 사용해 보시기 바랍니다.
|
|---|
|
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 계정 재활성화를 참조하세요.
|
|---|
| 예방법 |
취소됨 상태를 확인하면 고객 계정이 비활성화되었는지 사전에 확인할 수 있습니다.
|
|---|
|
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(-)로 지정합니다. 클라이언트 라이브러리에서 이를 기본적으로 지원합니다.
|
|---|
|
