각 Google Ads API 개발자 토큰에는 액세스 수준과 '허용되는 사용'이 할당됩니다. 액세스 수준에 따라 프로덕션 계정에 영향을 줄 수 있는지와 일일 실행할 수 있는 작업 및 요청 수가 결정됩니다. 허용된 용도는 개발자 토큰이 사용할 수 있는 특정 Google Ads API 기능을 결정합니다.
액세스 수준
표에는 네 가지 개발자 토큰 액세스 수준이 순서대로 나열되어 있습니다. Google Ads API 액세스 권한이 아직 없는 경우 가입하여 테스트 계정 액세스 수준의 개발자 토큰을 얻으세요. 애플리케이션에서 몇 가지 추가 단계를 완료하여 액세스 수준을 높일 수 있습니다.
| 액세스 수준 | 액세스할 수 있습니다. | 일일 작업 한도1 | 신청 방법 | 검토는 일반적으로 얼마나 걸리나요? |
|---|---|---|---|---|
| 테스트 계정 액세스 수준 | 테스트 계정 | 작업 15,000개 / 일 | 안내 | |
| 탐색기 액세스 수준 | 테스트 및 프로덕션 계정 | 프로덕션 계정의 경우 2,880회 / 일 테스트 계정의 경우 15,000회 / 일 |
안내 | |
| 기본 액세스 수준 | 테스트 및 프로덕션 계정 | 테스트 계정과 프로덕션 계정 모두 일일 15,000회 작업 | 안내 | 영업일 기준 2일 |
| 일반 액세스 수준 | 테스트 및 프로덕션 계정 | 테스트 계정과 프로덕션 계정 모두 일일 작업 무제한 | 안내 | 10 영업일 |
1 '일별'은 개발자 토큰으로 API 요청이 이루어진 24시간의 슬라이딩 기간을 기준으로 합니다. 애플리케이션이 지난 24시간 동안 액세스 수준의 요청 한도를 초과하면 오류가 발생합니다.
테스트 계정 액세스 수준
Google Ads API의 초기 가입을 완료하면 테스트 계정 액세스 수준의 개발자 토큰이 발급됩니다. 즉, 개발자 토큰은 테스트 계정에 대해서만 Google Ads API 요청을 할 수 있습니다.
테스트 계정 액세스 수준을 신청하는 방법
Google Ads 웹 인터페이스에서 Google Ads API 가입을 완료하면 테스트 계정 액세스 수준이 자동으로 부여됩니다.
탐색기 액세스 수준
Google Ads API의 초기 가입을 완료하면 경우에 따라 Google에서 개발자 토큰을 테스트 계정 액세스 수준에서 탐색기 액세스 수준으로 자동 업그레이드할 수 있습니다. 탐색기 액세스 수준을 사용하면 개발자 토큰이 테스트 계정과 프로덕션 계정 모두에 대해 Google Ads API 요청을 할 수 있습니다. 프로덕션 계정은 실제 라이브 Google 광고를 게재하는 계정입니다. 테스트 계정은 광고를 게재하지 않습니다.
탐색기 액세스 수준을 사용하면 개발자 토큰이 프로덕션 계정에 대해 하루 최대 2,880개의 작업을 실행할 수 있습니다. 이 정도면 대부분의 개발자가 API를 시작하고 기본 자동화를 빌드하기에 충분합니다.
탐색기 액세스 수준은 다음 기능에 대한 액세스를 제한합니다. 이러한 기능을 사용해야 하는 경우 기본 액세스 수준 또는 표준 액세스 수준을 신청해야 합니다.
탐색기 액세스 수준을 신청하는 방법
Google Ads 웹 인터페이스에서 Google Ads API 가입을 완료합니다. 경우에 따라 가입을 완료하면 Google에서 개발자 토큰을 탐색기 액세스 수준으로 자동 업그레이드할 수 있습니다.
기본 액세스 수준
기본 액세스 수준을 사용하면 개발자 토큰이 테스트 계정과 프로덕션 계정 모두에 대해 Google Ads API 요청을 할 수 있습니다. 프로덕션 계정은 실제 라이브 Google 광고를 게재하는 계정입니다. 테스트 계정은 광고를 게재하지 않습니다.
기본 액세스 수준을 사용하면 개발자 토큰이 하루에 최대 15,000개의 작업을 실행할 수 있습니다. 대부분의 개발자에게는 이 정도면 충분합니다.
기본 액세스 수준을 신청하는 방법
테스트 계정 액세스 수준의 개발자 토큰이 있고 프로덕션 계정 액세스를 신청하려면 기본 액세스 수준 신청 양식을 작성하세요. 다음 단계를 완료했는지 확인하세요.
- 테스트 계정 액세스 수준의 개발자 토큰이 이미 있는지 확인합니다.
- API 센터의 API 연락처 이메일이 최신 상태인지 확인합니다. API 센터를 보려면 Google Ads 관리자 계정에 로그인해야 합니다. 유효하고 정기적으로 확인하는 이메일 주소가 없으면 신청 절차를 완료할 수 없습니다. 운영 중인 모든 Google Ads 계정을 API 토큰이 있는 Google Ads 관리자 계정에 연결해야 합니다.
일반 액세스 수준
표준 액세스 수준을 사용하면 개발자 토큰이 대부분의 서비스에 대해 하루에 무제한으로 작업을 실행할 수 있습니다. 여기에는 GoogleAdsService Search 및 SearchStream이 포함되지만 이에 국한되지는 않습니다. 표준 액세스 수준의 한도 및 예외에 관한 자세한 내용은 API 할당량을 참고하세요.
표준 액세스 수준은 대기업이나 많은 사용자에게 서비스를 제공하는 도구와 같이 무제한 Google Ads API 작업이 필요한 개발자에게만 부여됩니다.
일반 액세스 수준을 신청하는 방법
기본 액세스 수준의 개발자 토큰이 있으며 무제한 Google Ads API 작업을 신청하려면 표준 액세스 수준 신청 양식을 작성하세요.
도구가 외부 도구인 경우 도구에 대한 데모 로그인 액세스 권한을 제공할 준비를 하세요. 도구가 필수 최소 기능을 준수해야 합니다.
API 할당량 및 시스템 비율 제한
액세스 수준과 관계없이 모든 API 작업에는 시간당 작업 수인 기간 내에 실행할 수 있는 작업 수를 제한하는 시스템 비율 제한이 적용됩니다. 요청 한도 오류를 처리하는 방법을 자세히 알아보려면 오류 유형을 참고하세요.
제품 설계 제한사항, 제품 정책 제한사항, API 성능 및 지연 시간 고려사항과 같은 이유로 개별 서비스에서 추가 한도 및 할당량 제한을 적용할 수 있습니다. 이러한 제한사항에 대한 자세한 내용은 API 할당량에 관한 문서를 참고하세요.
허용되는 사용
허용되는 사용은 기본 액세스 및 표준 액세스 수준의 개발자 토큰에만 적용됩니다. 허용된 사용량은 Google Ads API의 의도된 사용에 따라 할당됩니다. 이러한 권한은 개발자 토큰을 사용할 수 있는 API 기능을 결정합니다. 자세한 내용은 다음 표를 참고하세요.
| 허용되는 사용 | 설명 |
|---|---|
| 광고 작성 / 관리 | Google Ads 캠페인, 광고 그룹, 광고, 키워드를 생성하고 관리하기 위한 API의 모든 서비스에 대한 액세스 권한을 제공합니다. |
| 보고 | GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 요청이나 읽기 전용 호출만 합니다. API를 사용하여 통계를 요청하는 개발자를 위한 것입니다.
|
| 키워드 및 추천 조사 | 개발자 토큰이 RecommendationService, KeywordPlanIdeaService, KeywordPlanService에 액세스하도록 허용합니다.
이는 Google Ads 캠페인의 생성 및 관리를 용이하게 하기 위해 제안이 필요한 도구에서만 사용됩니다.
|
허용되는 사용 변경 방법
개발자 토큰이 기본 액세스 수준 또는 표준 액세스 수준으로 승인된 경우 허용되는 사용 업데이트 신청서를 작성할 수 있습니다. 허용되는 사용을 업데이트하거나 클라이언트에게 도구 액세스 권한을 부여하려면 신청서를 작성하세요.