Google Cloud 프로젝트에는 액세스 수준과 '허용되는 사용'이 할당됩니다. 액세스 수준 에 따라 프로덕션 계정에 영향을 미칠 수 있는지와 일일 실행할 수 있는 작업 및 요청 수가 결정됩니다. 허용되는 사용 은 프로젝트에서 사용할 수 있는 특정 Google Ads API 기능을 결정합니다.
액세스 수준
테이블에는 4가지 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 Ads API 를 Google Cloud 프로젝트에서 사용 설정하면 프로젝트에 테스트 계정 액세스 수준이 자동으로 부여됩니다.
탐색기 액세스 수준
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 프로젝트에 일반 액세스 수준이 승인된 경우 신청서를 작성하여 허용되는 사용을 업데이트할 수 있습니다. 허용되는 사용을 업데이트하거나 클라이언트에게 도구에 대한 액세스 권한을 부여하려면 신청서를 작성하세요.