Google Ads

FAQ  |  AdWords API  |  Google Developers

Signup

Pricing and Compliance

AdWords API Terms and Conditions Update

Signup

What’s my “company type”?
When you apply for access to the AdWords API, you’ll be asked for
your company type. Here are your options:

  • Advertiser – You manage Google Ads campaigns only for
    your company’s website(s), products, or services. You do not manage
    Google Ads campaigns for any other companies.
  • Agency/SEM – You manage
    Google Ads campaigns for clients, and may offer additional services related
    to online marketing, web hosting, SEO, etc.
  • Affiliate – You participate in other companies’
    affiliate programs. You use Google Ads to help advertise their products
    online.
  • Independent Google Ads Developer – You intend to use
    the AdWords API to develop and license software related to Google Ads. You
    do not manage Google Ads campaigns for clients.
What happened to the Integration Service company
type?

The Integration Service company type has been combined with Agency/SEM.
This will not affect your access to the API in any way.

What do I need to get started using the AdWords API after signup?

All you need to get started is an approved developer token. You can
acquire it after you register for the AdWords API.

After you sign up, your developer token will be sent to your account email address.
Once approved, this token will be activated and you’ll be able to access the API by
including it in your request headers. You can find the token on your manager account’s
AdWords API Center page.

How do I update my developer contact email?

To change/update your contact email, follow these instructions:

  1. Log in to your manager account and click the tool icon in the top-right.
  2. From the drop-down, click AdWords API Center.
  3. Under Developer Details, click API contact email.
  4. Enter a valid, up-to-date email address and click SAVE.
Can I start using the API as soon as I sign up?

After you provide your developer information, you’ll
be assigned a developer token, but you’ll need to wait until your token
has been approved before accessing the API. The AdWords API Review team
will contact you within one week of your application. In the meantime,
you may apply for a
Test Account in order
to begin developing and testing your application.

What information do you need about my application and
its users?

We want to know what your application will do (e.g. custom reports,
account management, bid optimization, etc.) and who’ll be using it
(e.g. colleagues in your company, your clients, advertisers or agencies
to whom you will sell the application, etc.). Please be thorough in your
description. The more you tell us about your application and users, the
faster you will be approved and the better we can understand your needs
in order to continue developing the best operations, resources, and
support for our users. We will not share any of the information you
provide to us with outside parties.

What are common reasons why a developer token would not
be approved?

The AdWords API
Terms & Conditions include detailed
guidelines for appropriate use of the AdWords API. You must agree to these
terms during the set-up step. If you have used, or intend to use,
the API in ways inconsistent with these terms, your tokens will not be
approved. If you are developing an external tool—one in which your
clients will access—your tool must implement our
Required Minimum Functionality.

Read more about signing up for the AdWords API.

Pricing and Compliance

Why is the AdWords API being offered for free?

We were charging a small fee for AdWords API usage to encourage
developers to create applications that interact with the Google Ads platform in an
efficient and responsible manner. In 2010 we launched the preferred pricing
program that offered free AdWords API units to eligible agencies and developers
of search engine marketing (SEM) tools. We got positive feedback from this
program and we now want to extend free usage to all developers to encourage
innovation.

What are the different access levels for the AdWords API?

There are two levels of AdWords API access:

  1. Basic
  2. Standard

The access levels pertain to number of daily operations only; there are still
token-level rate limits to prevent excessive stress on our systems and to
guarantee good performance for all our API users. All users are still required
to comply with
Google Ads terms,
AdWords API terms, and the
required minimum functionality,
where applicable. There will be no charges for AdWords API usage for either
basic or standard access.

Basic access: This is the default access level for all approved
developer tokens. Basic access allows developers to execute up to 10,000
operations and 1,000 report downloads per day.

Standard access: This is the access level for those needing more
usage capacity. Standard access requires developers to provide additional
details and keep these details current with Google.

What are non-compliance fees and how are they determined?

In order to ensure optimal advertiser and user experience, we monitor
AdWords API usage and application compliance to the AdWords API terms
and conditions.

If your application is not in compliance, you’ll be alerted and given a
period of time to make appropriate corrections. At the end of this initial
notice period, if the corrections aren’t made, then you may be given an
extension of up to 3 months. During this time you will be charged a monthly
non-compliance fee based on the greater of:

  • $1 for every 25,000 operations that were used in the
    month before you received your initial non-compliance notice.
  • $1 for every 25,000 report download requests issued in the
    month before you received your initial non-compliance notice.

Continued non-compliance will result in API access being revoked.

Read more about how operations are counted.

As an example, let’s say you executed 25 million operations in April, and we
found that your application was not in compliance with the AdWords API
terms and conditions. You would receive a 30-day notice on May 1 to bring
your application into compliance. If the required changes were not made by
May 31, you would be charged a flat non-compliance fee of $1,000/month
(25,000,000/25,000 x $1) for a maximum of 3 months (June, July, and August)
or until your application satisfies compliance requirements—whichever
comes first.

We were getting free API units for advertising our own business. Do we still
need to apply for standard access?

All developers requiring more than 10,000 operations or 1,000 report downloads
per day need standard access.
Allocation of free API units based on Google Ads spend will be retired. Based on your
history with the AdWords API and details you’ve shared with us, we may be able to
pre-qualify you for standard access. However, in order to ensure that your API access
is not affected, we encourage you to
apply for standard access.

We have already been approved for preferred pricing and get
free API units. Do we still need to apply for standard access?

You might or might not. The Preferred Pricing program which was offered to agencies
and search engine marketing tool developers, will be retired. Starting March 1, 2013,
all developers requiring more than 10,000 operations or 1,000 report downloads per
day will need standard access.
Based on your history with the AdWords API and details you’ve shared with us, we may be
able to pre-qualify you for standard access. However, in order to ensure that your
API access is not affected, we encourage you to
apply for standard access
if you have not heard from us OR if the details you had provided during your
preferred pricing application has changed recently.

Can we continue to pay current AdWords API charges and
not apply for standard access?

No. If you use or expect to use fewer than 10,000 operations and 1,000 report
downloads per day, you are not required to apply for standard access.

How are AdWords API operations counted?

Starting March 1, 2013, API units were deprecated and all operations are now counted equally.
report download requests will not be counted towards
the daily operations quota. In a batch job,
each operation is counted separately.

Each AdWords API operation such as a get or mutate is counted
separately. For example, a get operation that generates 10 results
objects will only be counted once. For mutates, each mutated item counts as one operation.
The following table gives some examples on how the new accounting will work:

API request Operations counted towards Daily Limit
Operation: get

Count: 53 ad groups

Service: AdgroupAdService
1
Operation: mutate (ADD)

Count: 2 ad groups

Service: AdgroupAdService
2
Operation: get

Count: 100 targeting ideas

Service: TargetingIdeaService
1
Operation: mutate (ADD)

Count: 10 campaigns

Service: BatchJobService
10
How can I find out what my API usage is, and whether I should apply for standard access?

Your app’s activity logs should allow you to calculate an estimate for API usage.

When should I apply for standard access?

If you did not apply for standard access before February 28, 2013, you
were defaulted to basic access. If you expect your usage to increase
beyond this limit in the future, you should apply for standard access at
a minimum 3 weeks ahead of time, and include as much details as possible
in your application to ensure timely processing of your request.

How long does it take for standard access to be approved?

If all the details you provided on the standard access form are accurate and any follow-up clarification questions are responded to promptly, we expect to complete the review in about two weeks.

What are some of the common reasons standard access approval may be delayed or not granted?

Some of the common reasons for delayed approvals are:

  • Incomplete details provided on the standard access application
  • Inaccurate contact details in the manager account that is associated with the AdWords API developer token
  • Not responding to follow-up questions and clarifications by the AdWords API support team
  • Using the API in ways inconsistent with the
    AdWords API terms and conditions
  • Not implementing the Required Minimum Functionality
  • Current AdWords API usage is very low and does not yet justify standard access
Do we need to re-apply for standard access at any time?

If the information you provided in the original standard access application changed or if the AdWords API
support team requests you to do so, you need to update your details using the standard access application form.

For example, if you were an advertiser for a single website but would now like to advertise on behalf
of multiple clients, or, if your tool had previously offered only reporting functionality and you would
now like to implement creation and management of campaigns, then you will need to provide the updated details
via the standard access form.

With API usage being free, do we still need to provide billing details when applying for the AdWords API token?

We no longer require billing information during signup. Details like
contact info are still needed. There are no charges for compliant API usage
under either basic or standard access.

AdWords API Terms and Conditions Update

What do I need to do if I’m a current AdWords API user?

As an AdWords API user, please accept the updated Terms and Conditions
to continue to use the AdWords API.

  • If you are a third party developing an API tool for a client who owns
    that software, and you don’t have the authority to accept on your clients’
    behalf, please ask your clients to sign in to their accounts to review and
    accept the updated terms.
  • You’ll receive an email with instructions on how to review and accept
    the new terms. Please note that if you don’t accept the terms within 45 days of
    receiving this email, we’ll consider you to have accepted the terms based on
    your continued use of your developer token.
Where do I find the new Terms and Conditions and how do I accept them?

In addition to instructions sent to you by email, you’ll also see a red
alert bar at the top of the manager account associated with your AdWords API
developer token containing a link to the new Terms and Conditions. To accept the
new terms, just follow the prompts.

You can also review the new Terms and Conditions.
To review our previous terms and conditions, see below.

I’m not seeing the new Terms and Conditions when I sign in to my account.

Don’t worry! If you’re not seeing the new terms when you sign in to your
account, there’s nothing more for you to do right now. Because we’re updating
the new terms on a rolling basis, you may be scheduled for a later time. Or the
terms may already have been accepted by someone else authorized to act on your
behalf.

What’s changed?

The updated Terms and Conditions are designed to be a more concise and
better organized way for you to understand what’s required of you as a user of
the AdWords API. As with any legal document, you might consider consulting an
attorney if you have legal questions. Here are some general pointers about the
new terms:

  • Accepting the new terms does not change any of your bids, budgets, or
    other campaign settings. As always, you’ll continue to control your settings
    in the Campaign tab of your account.
  • You’ll also see links to a new
    AdWords API
    Policy Center
    , which the new terms require you to follow.
  • Keep in mind that if you decline the new terms, your developer token will
    be terminated.


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.

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to top button
Close