이 페이지는 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만 사용하여 통계를 요청하는 개발자를 위한 것입니다.
키워드 및 추천 조사	토큰이 RecommendationService, KeywordPlanIdeaService, KeywordPlanService에 액세스하도록 허용합니다. Google Ads 캠페인 생성 및 관리를 용이하게 하기 위해 추천이 필요한 도구에서만 사용됩니다.

허용되는 사용 변경

기본 액세스 또는 일반 액세스 수준에 대한 승인을 받은 경우 허용된 사용 업데이트 신청서를 작성할 수 있습니다. 허용되는 용도를 업데이트하거나 고객에게 도구에 대한 액세스 권한을 부여하려면 신청서를 작성하세요.