Stay organized with collections Save and categorize content based on your preferences.
Each Google Ads API developer token is assigned an access level and "permissible use". The access level determines whether you can affect production accounts and the number of operations and requests that you can execute daily. Permissible use determines the specific Google Ads API features that the developer token is allowed to use.
Access levelsThere are three different access levels listed in order in the table. If you don't already have Google Ads API access, you can start by signing up to obtain test account access. You can increase the access level by completing some additional steps in the application.
Access level Can access... Daily operation limit1 Apply Test Account Access Test accounts 15,000 operations / day Instructions Basic Access Test and production accounts 15,000 operations / day Instructions Standard Access Test and production accounts Unlimited operations / day Instructions1 "Per day" is based on a sliding 24 hour time period in which API requests were made with your developer token. Your application will receive an error if it exceeds the request limit for your access level within the last 24 hours.
Test Account AccessAfter you've completed the initial sign-up for the Google Ads API, you're issued a developer token with the Test Account Access level. This means that the developer token can only make Google Ads API requests against test accounts.
Important: Refer to the test account guide to learn more about how to create a test account. How to apply for Test Account AccessComplete the Google Ads API sign-up on the Google Ads web interface to automatically be granted the Test Account Access level.
Basic AccessBasic Access level allows the developer token to make Google Ads API requests against both test accounts and production accounts. Production accounts are any accounts that serve real, live Google ads—test accounts don't serve ads.
Basic Access level allows the developer token to execute up to 15,000 operations per day. This is sufficient for most developers.
How to apply for Basic AccessIf you have a developer token with Test Account Access level and you would like to apply for production account access, fill out the Basic Access application form. Make sure you've completed these steps:
Standard Access level allows the developer token to execute an unlimited number of operations per day for most services. This includes but is not limited to GoogleAdsService
Search
and SearchStream
. For more details on limits and exceptions to Standard Access level, see API quotas.
The Standard Access level are only granted to developers who require unlimited Google Ads API operations, such as large companies or tools that serve many users.
Regardless of access level, all API operations are subject to system rate limits. To learn more about how to handle rate limit errors, see Error types.
How to apply for Standard AccessIf you have a developer token with Basic Access level and you would like to apply for unlimited Google Ads API operations, fill out the Standard Access application form.
If your tool is external, be prepared to provide demo sign-in access to your tool. Note that your tool must comply with the Required Minimum Functionality.
Permissible usePermissible use only applies to developer tokens with Basic Access and Standard Access levels. Permissible use is allocated based on intended use of the Google Ads API. These permissions determine which features of the API a developer token can be used for, as elaborated in the following table:
Permissible Use Description Ad creation / management Provide access to all services of the API for creating and managing Google Ads campaigns, ad groups, ads, and keywords. Reporting Only makeGoogleAdsService.Search
or GoogleAdsService.SearchStream
requests, or read-only calls. This is for developers who only use the API to request stats. 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. How to change permissible use
If your developer token has been approved for either the Basic Access or Standard Access level, you can fill out the application to update permissible use. Fill out the application if you would like to update your permissible use or grant your clients access to your tool.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["Google Ads API developer tokens have access levels (Test, Basic, Standard) and permissible use that determine API usage."],["Access levels control access to test/production accounts and daily operation limits, ranging from 15,000 to unlimited."],["Permissible use defines which API features the token can access, such as ad management, reporting, or keyword research."],["Developers can apply for increased access levels and modify permissible use through application forms."],["All API usage is subject to system rate limits, regardless of the access level granted."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4