이 페이지는 Cloud Translation API를 통해 번역되었습니다.

액세스 수준 및 허용되는 사용

각 Google Ads API 개발자 토큰에는 액세스 수준과 '허용된 사용'이 할당됩니다. 액세스 수준에 따라 프로덕션 계정에 영향을 미칠 수 있는지 여부와 매일 실행할 수 있는 작업 및 요청의 수가 결정됩니다. 허용된 사용이란 개발자 토큰에서 사용할 수 있는 특정 Google Ads API 기능을 지정합니다.

액세스 수준

표에는 세 가지 액세스 수준이 순서대로 표시되어 있습니다. Google Ads API 액세스 권한이 아직 없다면 가입하여 테스트 계정 액세스 권한을 얻을 수 있습니다. 애플리케이션에서 몇 가지 추가 단계를 완료하여 액세스 수준을 높일 수 있습니다.

액세스 수준	액세스 가능...	일일 작업 한도¹	적용
테스트 계정 액세스	테스트 계정	작업 15,000개 / 일	안내
기본 액세스	테스트 및 프로덕션 계정	작업 15,000개 / 일	안내
일반 액세스	테스트 및 프로덕션 계정	일일 무제한 운영	안내

¹ '일일'은 개발자 토큰으로 API 요청이 이루어진 24시간 슬라이딩 기간을 기준으로 합니다. 최근 24시간 내에 액세스 수준에 대한 요청 한도를 초과하면 애플리케이션에 오류가 수신됩니다.

테스트 계정 액세스

Google Ads API에 처음 가입을 완료하면 테스트 계정 액세스 수준의 개발자 토큰이 발급됩니다. 즉, 개발자 토큰은 테스트 계정에 대해 Google Ads API 요청만 할 수 있습니다.

테스트 계정 액세스 신청

Google Ads 웹 인터페이스에서 Google Ads API 가입을 완료하면 테스트 계정 액세스 수준이 자동으로 부여됩니다.

기본 액세스

기본 액세스를 사용하면 개발자 토큰으로 테스트 계정 및 프로덕션 계정 모두에 대해 Google Ads API 요청을 수행할 수 있습니다. 프로덕션 계정은 실제 실제 Google 광고를 게재하는 모든 계정입니다. 테스트 계정에는 광고를 게재하지 않습니다.

기본 액세스 수준을 사용하면 개발자 토큰에서 하루에 최대 15,000개의 작업을 실행할 수 있습니다. 대부분의 개발자에게는 이것으로 충분합니다.

기본 액세스 신청

현재 테스트 계정 액세스 수준 개발자 토큰이 있고 프로덕션 계정 액세스를 신청하려면 기본 액세스 신청 양식을 작성하세요. 다음 단계를 완료했는지 확인하세요.

테스트 계정 액세스 수준의 개발자 토큰이 이미 있는지 확인합니다.
API 센터의 API 연락처 이메일이 최신 상태인지 확인합니다. 정기적으로 확인하는 유효한 이메일 주소가 없으면 신청 프로세스를 완료할 수 없습니다. 모든 활성 Google Ads 계정을 API 토큰이 있는 관리자 계정에 연결했는지 확인하세요.

일반 액세스

일반 액세스를 사용하면 개발자 토큰으로 대부분의 서비스에 대해 하루에 무제한으로 작업을 실행할 수 있습니다. 여기에는 GoogleAdsService Search 및 SearchStream가 포함되나 이에 국한되지 않습니다. 표준 액세스 권한의 한도 및 예외에 대한 자세한 내용은 API 할당량을 참조하세요.

일반 액세스 수준은 많은 사용자에게 서비스를 제공하는 대기업 또는 도구와 같이 무제한 Google Ads API 작업이 필요한 개발자에게만 부여됩니다.

액세스 수준에 관계없이 모든 API 작업에는 시스템 비율 제한이 적용됩니다. 비율 제한 오류를 처리하는 방법에 관한 자세한 내용은 오류 유형을 참고하세요.

일반 액세스 신청

현재 기본 액세스 수준이 있지만 무제한 Google Ads API 작업을 신청하려면 일반 액세스 신청서 양식을 작성하세요.

외부 도구를 사용하는 경우 도구에 대한 데모 로그인 액세스 권한을 제공할 수 있도록 준비하세요. 도구는 필수 최소 기능을 준수해야 합니다.

허용되는 사용

허용되는 사용은 기본 액세스 토큰과 일반 액세스 토큰에만 적용됩니다. 허용되는 사용 범위는 Google Ads API의 의도된 용도에 따라 할당됩니다. 이러한 권한은 다음 표에 설명된 대로 토큰을 사용할 수 있는 API의 기능을 결정합니다.

허용되는 사용	설명
광고 생성 / 관리	Google Ads 캠페인, 광고그룹, 광고, 키워드를 만들고 관리하는 데 필요한 모든 API 서비스에 대한 액세스 권한을 제공합니다.
보고서	`GoogleAdsService.Search` 또는 `GoogleAdsService.SearchStream` 요청이나 읽기 전용 호출만 실행합니다. 이 API는 통계를 요청하는 데만 API를 사용하는 개발자를 위한 도움말입니다.
키워드 및 추천 조사	토큰이 RecommendationService, KeywordPlanIdeaService, KeywordPlanService에 액세스하도록 허용합니다. Google Ads 캠페인의 생성 및 관리를 촉진하기 위해 추천이 필요한 도구에서만 사용됩니다.

허용 사용 변경

기본 액세스 또는 일반 액세스 수준으로 승인을 받았다면 허용된 사용 사례 업데이트 신청서를 작성하면 됩니다. 허용 용도를 업데이트하거나 고객에게 도구 액세스 권한을 부여하려면 신청서를 작성하세요.