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