각 Google Ads API 개발자 토큰에는 액세스 수준과 '허용되는 사용'이 할당됩니다. 액세스 수준에 따라 프로덕션 계정에 영향을 줄 수 있는지 여부와 일일 실행할 수 있는 작업 및 요청 수가 결정됩니다.
허용되는 사용은 개발자 토큰이 사용할 수 있는 특정 Google Ads API 기능을 결정합니다.
액세스 수준
표에는 세 가지 액세스 수준이 순서대로 나열되어 있습니다. 아직 Google Ads API 액세스 권한이 없는 경우 가입하여 테스트 계정 액세스 권한을 얻으세요.
애플리케이션에서 몇 가지 추가 단계를 완료하여 액세스 수준을 높일 수 있습니다.
1 '일별'은 개발자 토큰으로 API 요청이 이루어진 24시간의 슬라이딩 기간을 기준으로 합니다. 애플리케이션이 지난 24시간 동안 액세스 수준의 요청 한도를 초과하면 오류가 발생합니다.
테스트 계정 액세스
Google Ads API의 초기 가입을 완료하면 테스트 계정 액세스 수준의 개발자 토큰이 발급됩니다. 즉, 개발자 토큰은 테스트 계정에 대해서만 Google Ads API 요청을 할 수 있습니다.
테스트 계정 액세스 권한을 신청하는 방법
Google Ads 웹 인터페이스에서 Google Ads API 가입을 완료하면 테스트 계정 액세스 수준이 자동으로 부여됩니다.
기본 액세스
기본 액세스 수준을 사용하면 개발자 토큰이 테스트 계정과 프로덕션 계정 모두에 대해 Google Ads API 요청을 할 수 있습니다. 프로덕션 계정은 실제 라이브 Google 광고를 게재하는 계정입니다. 테스트 계정은 광고를 게재하지 않습니다.
기본 액세스 수준을 사용하면 개발자 토큰이 하루에 최대 15,000개의 작업을 실행할 수 있습니다. 대부분의 개발자에게는 이 정도면 충분합니다.
기본 액세스 권한을 신청하는 방법
테스트 계정 액세스 수준의 개발자 토큰이 있고 프로덕션 계정 액세스를 신청하려면 기본 액세스 신청 양식을 작성하세요.
다음 단계를 완료했는지 확인하세요.
테스트 계정 액세스 수준의 개발자 토큰이 이미 있는지 확인합니다.
API 센터의 API 연락처 이메일이 최신 상태인지 확인합니다. API 센터를 보려면 관리자 계정에 로그인해야 합니다. 유효하고 정기적으로 확인하는 이메일 주소가 없으면 신청 절차를 완료할 수 없습니다. 활성 Google Ads 계정을 모두 API 토큰이 있는 관리자 계정에 연결했는지 확인합니다.
일반 액세스
표준 액세스 수준을 사용하면 개발자 토큰이 대부분의 서비스에 대해 하루에 무제한으로 작업을 실행할 수 있습니다. 여기에는 GoogleAdsServiceSearch 및 SearchStream이 포함되지만 이에 국한되지는 않습니다. 표준 액세스 수준의 한도 및 예외에 대한 자세한 내용은 API 할당량을 참고하세요.
표준 액세스 수준은 대기업이나 많은 사용자에게 서비스를 제공하는 도구와 같이 무제한 Google Ads API 작업이 필요한 개발자에게만 부여됩니다.
액세스 수준과 관계없이 모든 API 작업에는 시스템 비율 제한이 적용됩니다. 비율 제한 오류를 처리하는 방법을 자세히 알아보려면 오류 유형을 참고하세요.
표준 액세스 권한을 신청하는 방법
기본 액세스 수준의 개발자 토큰이 있고 무제한 Google Ads API 작업을 신청하려면 표준 액세스 신청 양식을 작성하세요.
도구가 외부 도구인 경우 도구에 대한 데모 로그인 액세스를 제공할 준비를 하세요. 도구가 필수 최소 기능을 준수해야 합니다.
허용되는 사용
허용되는 사용은 기본 액세스 및 표준 액세스 수준이 있는 개발자 토큰에만 적용됩니다. 허용되는 사용량은 Google Ads API의 의도된 사용에 따라 할당됩니다. 이러한 권한은 개발자 토큰을 사용할 수 있는 API 기능을 결정합니다. 자세한 내용은 다음 표를 참고하세요.
허용되는 사용
설명
광고 작성 / 관리
Google Ads 캠페인, 광고 그룹, 광고, 키워드를 생성하고 관리하기 위한 API의 모든 서비스에 대한 액세스 권한을 제공합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[[["\u003cp\u003eGoogle Ads API developer tokens have access levels (Test, Basic, Standard) and permissible use that determine API usage.\u003c/p\u003e\n"],["\u003cp\u003eAccess levels control access to test/production accounts and daily operation limits, ranging from 15,000 to unlimited.\u003c/p\u003e\n"],["\u003cp\u003ePermissible use defines which API features the token can access, such as ad management, reporting, or keyword research.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can apply for increased access levels and modify permissible use through application forms.\u003c/p\u003e\n"],["\u003cp\u003eAll API usage is subject to system rate limits, regardless of the access level granted.\u003c/p\u003e\n"]]],[],null,["# Access Levels and Permissible Use\n\nEach Google Ads API developer token is assigned an access level and \"permissible\nuse\". The **access level** determines whether you can affect production accounts\nand the number of operations and requests that you can execute daily.\n**Permissible use** determines the specific Google Ads API features that the\ndeveloper token is allowed to use.\n\nAccess levels\n-------------\n\nThere are three different access levels listed in order in the table. If you\ndon't already have Google Ads API access, you can start by [signing\nup](/google-ads/api/docs/get-started/dev-token#apply-token) to obtain test account access.\nYou can increase the access level by completing some additional steps in the\napplication.\n\n| Access level | Can access... | Daily operation limit^[1](#superscript-1)^ | Apply |\n|---------------------|------------------------------|--------------------------------------------|-----------------------------------------------------------------------------------|\n| Test Account Access | Test accounts | 15,000 operations / day | [Instructions](/google-ads/api/docs/get-started/dev-token#apply-token) |\n| Basic Access | Test and production accounts | 15,000 operations / day | [Instructions](//support.google.com/adspolicy/contact/new_token_application) |\n| Standard Access | Test and production accounts | Unlimited operations / day | [Instructions](//support.google.com/adspolicy/contact/standard_token_application) |\n\n\n^1^ \"Per day\" is based on a sliding 24 hour time period in which API\nrequests were made with your developer token. Your application will receive an\nerror if it exceeds the request limit for your access level within the last 24\nhours.\n\nTest Account Access\n-------------------\n\nAfter you've completed the initial sign-up for the Google Ads API, you're issued\na developer token with the Test Account Access level. This means that the\ndeveloper token can only make Google Ads API requests against test accounts.\n| **Important:** Refer to the [test account\n| guide](/google-ads/api/docs/best-practices/test-accounts) to learn more about how to create a test account.\n\n### How to apply for Test Account Access\n\nComplete the [Google Ads API sign-up](/google-ads/api/docs/get-started/dev-token#apply-token)\non the Google Ads web interface to automatically be granted the Test Account\nAccess level.\n\nBasic Access\n------------\n\nBasic Access level allows the developer token to make Google Ads API requests against\nboth test accounts and production accounts. **Production accounts** are any\naccounts that serve real, live Google ads---test accounts don't serve ads.\n\nBasic Access level allows the developer token to execute up to 15,000 operations\nper day. This is sufficient for most developers.\n\n### How to apply for Basic Access\n\nIf you have a developer token with Test Account Access level and you would\nlike to apply for production account access, [fill out the Basic Access\napplication form](//support.google.com/adspolicy/contact/new_token_application).\nMake sure you've completed these steps:\n\n1. Ensure that you already have a developer token with Test Account Access level.\n2. Ensure that the **API Contact Email** in the API center is up-to-date. You must be logged in to your manager account to see the API center. You won't be able to complete the application process without a valid, regularly checked email address. Ensure you have linked all of your active Google Ads accounts to the manager account with the API token.\n\nStandard Access\n---------------\n\nStandard Access level allows the developer token to execute an unlimited number\nof operations per day for most services. This includes but is not limited to\n`GoogleAdsService` [`Search`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Search) and\n[`SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream). For more details\non limits and exceptions to Standard Access level, see\n[API quotas](/google-ads/api/docs/best-practices/quotas).\n\nThe Standard Access level are only granted to developers who require\nunlimited Google Ads API operations, such as large companies or tools that\nserve many users.\n\nRegardless of access level, all API operations are subject to system rate\nlimits. To learn more about how to handle rate limit errors, see\n[Error types](/google-ads/api/docs/best-practices/error-types#retryable_errors).\n\n### How to apply for Standard Access\n\nIf you have a developer token with Basic Access level and you would like to\napply for unlimited Google Ads API operations, [fill out the Standard Access\napplication form](//support.google.com/adspolicy/contact/standard_token_application).\n\nIf your tool is external, be prepared to provide demo sign-in access to\nyour tool. Note that your tool must comply with the [Required Minimum\nFunctionality](/google-ads/api/docs/rmf).\n\nPermissible use\n---------------\n\nPermissible use only applies to developer tokens with Basic Access and Standard\nAccess levels. Permissible use is allocated based on intended use of the\nGoogle Ads API. These permissions determine which features of the API a developer token\ncan be used for, as elaborated in the following table:\n\n| Permissible Use | Description |\n|------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Ad creation / management | Provide access to all services of the API for creating and managing Google Ads campaigns, ad groups, ads, and keywords. |\n| Reporting | Only make [GoogleAdsService.Search](/google-ads/api/reference/rpc/v21/GoogleAdsService/Search) or [GoogleAdsService.SearchStream](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream) requests, or read-only calls. This is for developers who only use the API to request stats. |\n| Researching keywords and recommendations | Allow the token to access RecommendationService, KeywordPlanIdeaService, and KeywordPlanService. This is only used by tools requiring suggestions to help facilitate the creation and management of Google Ads campaigns. |\n\n### How to change permissible use\n\nIf your developer token has been approved for either the Basic Access or\nStandard Access level, you can fill out the [application to update permissible\nuse](//support.google.com/adspolicy/contact/tool_change). Fill out the\napplication if you would like to update your permissible use or grant your\nclients access to your tool."]]
