Today we’re announcing the release of AdWords API v201607. Here are the highlights: If you’re using v201601 or v201603 of the AdWords API, please note that they’re now deprecated and will be sunset on August 27, 2016 and October 25, 2016, respectively. We encourage you to skip v201605 and migrate straight to v201607.

As with every new version of the AdWords API, we encourage you to carefully review all changes in the release notes and the v201607 migration guide. The updated client libraries and code examples will be published shortly.

If you have any questions or need help with migration, please post on the forum or the Ads Developers Plus Page.


On Wednesday, August 31, 2016, in accordance with the deprecation schedule, v201505 of the DFP API will be sunset. At that time, any requests made to v201505 will return errors.

If you're still using v201505, now's the time to upgrade to the latest release and take advantage of new features like workflow progress for Sales Manager. To do so, check the release notes to identify any breaking changes, grab the latest version of your client library and update your code.

Significant changes include:

This is not an exhaustive list, so as always, don't hesitate to reach out to us with any questions. To be notified of future deprecations and sunsets, join the DFP API Sunset Announcements group and adjust your notification settings.

What’s changing?

As announced yesterday, expanded text ads are now fully available to all AdWords accounts. Expanded text ads feature two headlines and a single long description line, and are optimized for the screen sizes of the most popular smartphones.

Starting October 26, 2016, expanded text ads will become the primary Search network ad type, and creation of standard TextAds will no longer be supported in AdWords. To make changes to text ads after October 26th, you will need to create a new ExpandedTextAd or ResponsiveDisplayAd as announced in the v201605 release. Expanded text ads are the next generation of standard text ads, and responsive ads for Display are the preferred upgrade option for text ads on the Google Display Network. Responsive ads are currently being rolled out to all accounts.

To get started with expanded text ads, check out these upgrade tips. To get started with responsive ads, check out these upgrade tips. The expanded text ads guide and responsive ads for Display guide provide details and code samples in multiple programming languages.

Where can I learn more?
Questions? Visit us on the AdWords API Forum or our Google+ page.

The expanded text ad format is now fully supported in Scripts. Expanded text ads are the next generation of the standard AdWords text ad and are optimized for smartphone screen sizes. The new format features two headlines, each up to 30 characters, and one 80-character description line. See our guide on ad types and related code snippets to learn more about using expanded text ads in Scripts.

Along with the AdWords user interface, AdWords scripts will stop supporting the creation of standard text ads on October 26, 2016. If you use the AdGroup.newTextAdBuilder() method to create standard text ads, be sure to update your scripts to use the new ExpandedTextAdBuilder class. Existing standard text ads will continue to serve beyond this date and scripts will still be able to retrieve them.

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.


A new episode of The Mobile Ads Garage has hit YouTube! If you haven't seen it before, The Mobile Ads Garage is a video tutorial series that covers how to use the Mobile Ads SDK to display ads from AdMob and Doubleclick For Publishers. Each episode covers one aspect of the SDK, breaks down the feature, and shows screencasts of real implementations on both Android and iOS – all in a friendly format.

Have you tried AdMob's Native Ads Express? It's a new native ads format open to all AdMob publishers that can help you slim down the monetization code in your apps, plus give you the chance to update your ad layouts without a redeploy. In this episode you'll see sample ads, implementations in Xcode and Android Studio, and details on how to create CSS templates that'll make sure the ads in your apps look the way you want. If you've been considering a move to native ads, this is a great way to get started.

If you like the video, save the Mobile Ads Garage playlist to your YouTube Playlist collection and you'll never miss an episode.

We’d love to hear which AdMob features you’d like to learn more about. The comment sections for the videos are open, and you're welcome to toss out ideas for new episodes and examples you'd like to see. If you have a technical question relating to something discussed in one of the episodes, you can bring it to our support forum.

We are sunsetting support for the promotion line field of Product Ads in AdWords Scripts, since this feature has been retired in AdWords in favor of automated extensions.

As part of this change, we have marked the getPromotionLine() method of ProductAd and the withPromotionLine() method of ProductAdBuilder as deprecated. These methods will start throwing errors on September 15, 2016. If your script uses these methods, then make sure you review them and make necessary changes to ensure they continue to work as expected.

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

We are delighted to announce the introduction of additional Metrics and Dimensions which are now available through the reports resource; the API now returns most of the fields that the UI Query tool makes available.

The Metrics and Dimensions reference page now includes the UI field names to help make conversions simpler.

New Dimensions New Metrics