액세스 수준 및 허용 가능한 사용

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

액세스 수준

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

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

1 '일일'은 API 토큰이 개발자 토큰에 대해 생성된 24시간 슬라이딩 기간을 기준으로 합니다. 지난 24시간 내에 액세스 수준에 대한 요청 한도를 초과하면 애플리케이션에 오류가 발생합니다.

테스트 계정 액세스

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

테스트 계정 액세스 신청하기

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

기본 액세스

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

기본 액세스 수준을 통해 개발자 토큰을 통해 매일 최대 15,000회의 연산을 실행할 수 있습니다. 대부분의 개발자는 이것으로 충분합니다.

기본 액세스 신청하기

현재 테스트 계정 액세스 수준 개발자 토큰이 있는 경우 프로덕션 계정 액세스를 신청하려면 기본 액세스 신청서 양식을 작성하세요. 다음의 간단한 단계를 따랐는지 확인하세요.

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

일반 액세스

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

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

일반 액세스 신청하기

현재 기본 액세스 수준을 보유하고 있으며 무제한 Google Ads API 작업을 신청하려면 일반 액세스 신청 양식을 작성하세요.

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

허용되는 사용

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

허용되는 사용 방법은 다음과 같습니다.

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

허용되는 사용 변경

기본 액세스 수준 또는 일반 액세스 수준을 승인받은 경우 허용 사용을 위한 신청서를 작성하세요. 허용되는 사용을 업데이트하려는 경우 또는 클라이언트에 도구 액세스 권한을 부여하려면 애플리케이션을 작성하세요.