Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

Obtain Your Developer Token

Synopsis

A developer token from Google lets your app connect to the Google Ads API. To retrieve your developer token, sign in to your manager account. You must be signed-in to a Google Ads manager account before continuing.

Navigate to TOOLS & SETTINGS > SETUP > API Center. This option appears only for Google Ads manager accounts.

If your developer token is pending approval, you can start developing immediately with the pending token you received during signup, using a test manager account.

Your pending developer token must be approved before using it with production Google Ads accounts.

Procedure

Step 1: Select or create a Google Ads manager account

You must have a Google Ads manager account to apply for access to the API.

Manager accounts cannot be created using the same email address as an existing Google Ads account. You must therefore use an email address that hasn't already been associated with a Google Ads account to create your manager account.

Note that the manager account you select has no effect on the set of Google Ads accounts that your API token can access. It is purely a container to hold the developer token. The token itself can access any account as long as you have proper OAuth credentials. However, linking this manager account to your company's active Google Ads accounts will streamline the app review process and reduce the number of times you need to go through the authentication process to manage your accounts with the API. For details, see the Help Center article about linking accounts.

Step 2: Apply for access to the Google Ads API

Sign up for Google Ads API access through your manager account. Sign in, then navigate to TOOLS & SETTINGS > SETUP > API Center. The API Center option appears only for Google Ads manager accounts.

All fields on the API Access form must be completed, and the Terms and Conditions accepted. Make sure your information is correct and your company's website URL is functioning. If the website is not a live page, we won't be able to process your application.

Make sure the API contact email you provide leads to a regularly monitored inbox. If we cannot contact you at this email address, we won't be able to process your application, and it will be rejected.

You can edit your API contact email in the API Center.

We strongly encourage you to keep this information up-to-date, even after the application process, so we can send you important service announcements.

Step 3: Continue your application

To ensure the tool or software app you propose to use with the Google Ads API is in compliance with our Terms and Conditions and Policies, including Required Minimum Functionality (RMF) (if applicable), click the Apply for Basic Access link in the API Center, and complete the Google Ads API Token Application form.

We typically contact you within two business days of the date you submitted your application, at the email address you provided in Step 2. If you no longer have access to this inbox, or if you're not planning to actively monitor this email address, edit your email address in the API Center by following the instructions above in Step 2, so we can contact you.

Token review team has approved my developer token

Your assigned developer token will be activated once your application for API access is approved. Your token will be available through your API Center—accessible through the Account settings menu for the manager account from which you applied. You'll be able to access the API by including it in your request headers when interacting with our system.

It's very important that you keep your contact email current, as we send important information regarding changes or disruptions to service to the email address you specify.

If you make any changes to your tool in the future, you must report these changes to Google by filling out this form.

Token review team has rejected my application

The Token Review team examines the information you provide when you apply for access to the Google Ads API to make sure your software adheres to the Google Ads API Terms and Conditions (T&C) as well as the Required Minimum Functionality (RMF) (if applicable).

Common reasons for rejecting an application include:

  • We're unable to reach you at the contact email address you provided.
  • You have applied because a tool you use from a third party requires a developer token.
  • Your application violates other provisions in the Terms and Conditions.
  • Your application does not implement required elements of the Required Minimum Functionality (if applicable).

If you have altered your API tool to adhere to Google Ads API policy, or if you believe your application was incorrectly rejected, you can reapply by clicking the Reapply link in the API Center page of your manager account.

If you haven't received an email from us about your application within the expected time, fill out this form.

Billing

There is no charge for Google Ads API usage. We do charge non-compliance fees for failing to comply with Required Minimum Functionality. See the rate sheet for more details.