이 페이지에서는 일반적인 오류를 나열하고 이러한 오류를 방지하고 처리하는 방법에 관한 팁을 제공합니다.
전체 오류 목록은 오류 참조를 참고하세요. 추가 지원이 필요하면 포럼을 방문하세요.
google.auth.exceptions.RefreshError
invalid_grant
요약
토큰이 만료되었거나 취소되었습니다.
일반적인 원인
외부 사용자 유형으로 구성된 OAuth 동의 화면이 있고 게시 상태가 Testing인 Google Cloud Platform 프로젝트에는 7일 후에 만료되는 새로고침 토큰이 발급됩니다.
처리 방법
Google 프로젝트의 게시 상태가 Testing이므로 새로고침 토큰이 7일마다 만료되고 invalid_grant 오류가 발생합니다. Google API 콘솔로 이동하여 OAuth 동의 화면으로 이동합니다. 그런 다음 다음 안내에 따라 게시 상태를 In production로 변경하여 7일 후에 새로고침 토큰이 만료되지 않도록 하세요.
123-456-7890은 1234567890이어야 합니다. 자세한 내용은 시작하기를 참고하세요.
CLIENT_CUSTOMER_ID_IS_REQUIRED
요약
HTTP 헤더에 클라이언트 고객 ID가 지정되지 않았습니다.
일반적인 원인
HTTP 헤더에 클라이언트 고객 ID를 지정하지 않았습니다.
처리 방법
해당 사항 없음
예방법
모든 호출에는 클라이언트 고객 ID가 필요하므로 HTTP 헤더에 클라이언트 고객 ID를 지정했는지 확인하세요. Google의 클라이언트 라이브러리를 사용하면 이 작업이 자동으로 처리됩니다.
CUSTOMER_NOT_FOUND
요약
헤더에 제공된 고객 ID의 계정을 찾을 수 없습니다.
일반적인 원인
백엔드에서 계정이 설정되기 전에 방금 생성된 계정에 액세스하려고 합니다.
처리 방법
처음 5분 동안 기다린 후 30초마다 다시 시도합니다.
예방법
계정이 생성된 후 몇 분 정도 기다린 다음 계정에 대한 요청을 실행합니다.
GOOGLE_ACCOUNT_COOKIE_INVALID
요약
요청 헤더의 액세스 토큰이 잘못되었거나 만료되었습니다.
일반적인 원인
액세스 토큰이 무효화되었습니다.
처리 방법
새 토큰을 요청합니다. Google 클라이언트 라이브러리 중 하나를 사용 중인 경우 토큰을 새로고침하는 방법에 관한 문서를 참고하세요.
예방법
액세스 토큰이 만료될 때까지 저장하고 재사용합니다.
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 가이드를 참고하세요.
각 Google API Console 프로젝트는 하나의 관리자 계정에서만 개발자 토큰과 연결할 수 있습니다. Google Ads API 요청을 하면 개발자 토큰이 Google API 콘솔 프로젝트에 영구적으로 페어링됩니다. 새 Google API 콘솔 프로젝트를 사용하지 않으면 요청할 때 DEVELOPER_TOKEN_PROHIBITED 오류가 발생합니다.
이는 요청 애플리케이션에 대한 액세스 권한이 이미 부여된 사용자의 갱신 토큰을 생성하려고 할 때 발생합니다. 예를 들어 동일한 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"]],["최종 업데이트: 2024-12-02(UTC)"],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]
