Google Ads Developer Blog

Python 2 Deprecation in Ads API Client Libraries

Tuesday, April 2, 2019

As the official End of Life date for Python 2 approaches, we will be ending support for Python 2 in both the AdWords/Google Ad Manager and Google Ads Python client libraries in 2019. After deprecation the minimum required Python version for both libraries will be 3.6+.

Deprecation will begin with the AdWords/Google Ad Manager Python client library in May. Here’s a timeline for easy reference:

mid-May: version 19.0.0 is released to support Google Ad Manager API v201905. Python 2 users should not upgrade to any major version beyond this.
mid-May - late-June: Python 2 deprecation window.
Last week in June: version 20.0.0 is released that is incompatible with Python 2.
July 1: Support for Python 2-related issues in the library ends.

If you are a user of the AdWords/Google Ad Manager client library, please take note of the following:

Google Ad Manager Users:
- If you’re already using Python 3, no need to take action.
- If you’re using Python 2 you should remain on version 19.0.0 until you’ve migrated to Python 3.
AdWords Users:
- Please migrate to the new Google Ads API.
- If you’re using Python 2 you should remain on version 19.0.0 until you’ve migrated to the Google Ads API.
All Users:
- Beginning July 1, 2019 we will discontinue prioritizing work and triaging GitHub Issues related to compatibility with Python 2. Note that we will submit patches to version 19.0.0 if any major bugs arise after this deadline.

The Google Ads API client library will continue to be compatible with Python 2 until the end of 2019. We will post more information about that migration at a later date. In the meantime, Python 2 users should start planning their migration to Python 3 as soon as possible in order to avoid complications.

If you have questions about the Python 3 migration please submit an issue on the respective GitHub repository, and for general API support please reach out to us on the Google Ads API forum or the Google Ad Manager API forum.

Ben Karl, Google Ads API Team

Announcing v1_1 of the Google Ads API

Wednesday, March 27, 2019

Today we’re announcing the v1_1 release of the Google Ads API. With this version, you’ll continue pointing to v1 as your endpoint; however, you'll need to update your client libraries in order to use v1_1 features. If you're still on the AdWords API, now is a good time to give the new API a try.

Here are the highlights:

What resources are available?
Check out these helpful resources:

The updated client libraries and code examples will be published by March 29, 2019. If you have any questions or need help, please contact us via the forum.

Nadine Sundquist, Google Ads API Team

Announcing v2.1 of the Content API for Shopping

Monday, March 25, 2019

Today we're announcing the release of v2.1 of the Content API for Shopping. This version has been available as an experimental version since late last year and is now ready for production use by all Content API users.

Highlights
You can find a complete list of changes in the release notes and accompanying migration guide, but here are some highlights:

A more consistent product validation experience. Product insert requests no longer report non-fatal warnings or errors. This allows you to insert products and make subsequent updates to resolve issues via feed rules in the Merchant Center UI, just as you would with feeds maintained outside the API.
A better experience for managing Shopping Actions. Multiple improvements have been made to the Orders API based on feedback from beta users.
More features are on the way! Today's release contains many improvements, but more are on the way, including new ways to supply local inventory data and features to support supplemental feeds.
Continued v2 support. While we strongly encourage you to migrate to v2.1, support for v2 will continue at least through the first quarter of 2020. Subscribe to this blog to ensure you receive important updates on Content API releases and deprecations.

Updated client libraries
Updated client libraries with support for v2.1 are now available in multiple languages.

Learn more
Check out the v2.1 API reference documentation to explore the new version of the API, and read through the list of behavior changes and deprecations in the migration guide to help plan your upgrade to v2.1.

If you have any questions or need help with migration, please head over to our support forum.
- Josh Radcliff, Content API for Shopping Team

Structured Data Files v4.2 now available in the DoubleClick Bid Manager API

Thursday, March 21, 2019

Today we're announcing the general availability of Structured Data Files (SDF) v4.2 in the DoubleClick Bid Manager API. Highlights of this release include:

Support for TrueView connected TV bid adjustments
Ability to inherit Insertion Order start and end dates at the Line Item level
Renaming changes to better align SDF with the Display & Video 360 UI

All SDF users are encouraged to begin requesting v4.2 files to take advantage of these new features. To do so, simply pass 4.2 as the value of version when calling Sdf.download. For users with workflows that are dependent on older SDF formats, details of the file format changes between versions can be found in the release notes.

- Jonathon Imperiosi, DBM API Team

Registration open for Google Ads scripts 2019 workshops

Monday, March 18, 2019

Join us for informative talks and interactive codelabs at our 2019 Google Ads scripts workshops in Europe, Asia, and Australia from April through June.

The curriculum at each of the 6 workshops will be the same, so make sure to sign up for the one that's most convenient for you.

Please visit the event sites below for more details and to register for an event near you. We will be hosting the following sessions:

We hope to see you there!

- Mike Cloonan, Google Ads Scripts Team

Introducing the Google Ads Query Builder tool

Monday, March 11, 2019

Today we are excited to announce that the Google Ads Query Builder tool is now available on the Google Ads API Developer Site.

The Google Ads API has a robust reporting system that utilizes our new Google Ads Query Language. The language’s syntax allows you to select from all the resources that are available for reporting, and also filter or sort the result set on the server before they are returned to your application.

This tool provides a friendly web interface for you to explore our API’s reporting capabilities, and generate queries that you can copy and paste right into your applications. You can visit the site and try out the tool today!

Example usage of the Google Ads Query Builder: A screenshot showing a sample usage of the Google Ads Query Builder UI, including both filtering and ordering.

A screenshot showing a sample usage of the Google Ads Query Builder UI, including both filtering and ordering.

Happy reporting!

- Cory Liseno, Google Ads API Team

Google Ads API Policy Notes

Tuesday, March 5, 2019

In our recent blog post we announced the launch of Google Ads API v1. Since the Google Ads API and AdWords API can both be used in production systems, we'd like to clarify a couple of policy items.

Terms and Conditions
You will need to accept our updated Terms and Conditions to access production-ready versions of the Google Ads API. If you attempt to access v1 without accepting the new terms, your request will fail with the error AuthorizationError.MISSING_TOS. Existing AdWords API users will not be required to re-accept the new Terms and Conditions to access the legacy API. For instructions on how to accept the new terms, please take a look at this blog post.

Rate Limits
All Google Ads API rate limits are independent of a developer's use of the AdWords API. If a developer token with Basic Access sends a request to one Ads API, the daily request limit for the other API will not be affected.

Furthermore, daily limits for Basic Access developer tokens are different in the Google Ads API than in the AdWords API. They have been set to accommodate the new GoogleAdsService, which is the unified object retrieval and reporting service. Developer tokens with Basic Access can issue 15,000 requests per day. GoogleAdsService.Search requests with the page_token field set, will not count towards the Basic Access limit.

Note: All developer tokens are subject to the daily limit of 1,000 get requests.

Required Minimum Functionality (RMF)
Standard Access tools will continue to be subject to RMF policies. As these tools migrate their functionalities off of the legacy API, they can achieve RMF compliance by using either the AdWords API, Google Ads API or a combination of the two. Required features that are available in both APIs will be documented on both developer sites.

The Google Ads API RMF guide will contain the most up to date RMF list. This list will be made up of RMF items available in the AdWords API as well as new required functionalities that will be made available only in the Google Ads API. RMF due dates for new features will take into account migration efforts from the AdWords API to the Google Ads API.

Resources
For more information on these policy updates, please take a look at the following Google Ads API resources:

If you have any questions or need help, please contact us via the forum.
--Google Ads API Team

Ads Developer Blog

Python 2 Deprecation in Ads API Client Libraries

Announcing v1_1 of the Google Ads API

Announcing v2.1 of the Content API for Shopping

Structured Data Files v4.2 now available in the DoubleClick Bid Manager API

Registration open for Google Ads scripts 2019 workshops

Introducing the Google Ads Query Builder tool

Google Ads API Policy Notes

Labels

Archive

Feeds

Google Ads API [+]

AdWords API [+]

Google Ads scripts [+]

Content API for Shopping [+]

Google Ad Manager API [+]

DCM API [+]

Mobile Ads [+]

IMA SDK [+]

More Google blogs