What's New in Google Ads Scripts

August 6, 2020

• Added support for search.

February 24, 2020

• Added support for new responsive display ads.

August 8, 2019

• Added support for price extensions.

August 1, 2019

• Removed support for creating several deprecated kinds of ads:

  • Text ads (replaced by expanded text ads)
  • HTML5 ads
  • Gmail image ads
  • Gmail single promotion ads
  • Gmail multi product ads

  Attempts to create any of these ad types would already fail, but now the builder will throw an exception instead of trying to build the ad.

May 24, 2019

• Released the latest version of the following script solution, which is available for all account types:

  • Audience Assistant

November 27, 2018

• As part of the "AdWords" to "Google Ads" rebranding, AdWordsApp and MccApp have been renamed to AdsApp and AdsManagerApp, respectively. Although the old names will continue to work, old scripts have been migrated to the new names and you should use the new names going forward.

September 28, 2018

• Added support for working with additional headline and description fields in Expanded Text Ads.

  • Added getHeadlinePart3 and getDescription2 to ExpandedTextAd.
  • Added withHeadlinePart3 and withDescription2 to ExpandedTextAdBuilder.

• Added support for working with Negative Keyword Lists in Shopping Campaigns.

  • Added negativeKeywordLists and addNegativeKeywordList and removeNegativeKeywordList to ShoppingCampaign.

July 19, 2018

• Added new Campaign Drafts and Experiments feature.

April 30, 2018

• Added support for working with action ads in TrueView for action video campaigns.

  • Added withCallToAction and withActionHeadline to InStreamAdBuilder.
  • Added withCpa to VideoAdGroupBuilder.
  • Added getCpa and setCpa to VideoAdGroupBidding.

April 19, 2018

• Added getTotalAmount, setTotalAmount, and getType methods to the Budget class, to support "Campaign total" budgets in Video campaigns.

March 27, 2018

• Support for AdWords API v201802 reports has been added.

November 14, 2017

• The "Bid to Position" script has been updated to optimize on impression share instead.

July 27, 2017

• You can now access the Google Slides API through Apps Script → Advanced APIs. Guide | Code snippets

June 12, 2017

• Support for AdWords API v201705 reports has been added.

May 3, 2017

• Added new extension types: message and structured snippet.

  • Message
  • Snippet

April 19, 2017

• Added support for budget orders and user lists.

  • BudgetOrder | Code snippets
  • UserList | Code snippets

March 28, 2017

• Support for AdWords API v201702 reports has been added.

December 13, 2016

• Support for video campaigns has been added. Guide | Solution | Code snippets | Reference

November 2, 2016

• Support for AdWords API v201609 reports has been added.

October 18, 2016

• getConvertedClicks() and getClickConversionRate() have been deprecated and will sunset on February 21, 2017. Use the new getConversions() and getConversionRate() methods instead.

October 6, 2016

• Support for AdWords API v201607 reports has been added.

September 21, 2016

• Support for search/shopping audiences has been added. Code snippets

July 26, 2016

• Support for expanded text ads has been added.

July 6, 2016

• Support for AdWords API v201605 reports has been added.

May 3, 2016

• Support for AdWords API v201603 reports has been added.

February 17, 2016

• Released the following new script solutions, some of which are available in manager account versions:

  • BigQuery Exporter
  • Mobile PageSpeed
  • TV Schedule Bid Coordination
  • Account Auditor
  • Negative Keyword Conflicts
  • Large Manager Hierarchy Template

• Added support for AdWords API v201601 reports.

October 21, 2015

• Support for AdWords API v201509 reports has been added.

September 10, 2015

• Support for shared sets has been added. This will allow scripts to build and manage lists of negative keywords and placements that can be shared across campaigns. Solutions | Code snippets (keyword, placement)

July 8, 2015

• Policies on permissible uses of Google Ads scripts have been posted.

June 4, 2015

• You can now pass account-specific information to parallel functions through an optional input parameter, via AdsManagerApp.executeInParallel(). Guide

• You can now clear mobile bid modifiers at the ad group level. Docs

• We have added support for Upgraded URLs in app extensions. The setLinkUrl() method in MobileApp, AccountMobileApp, CampaignMobileApp, AdGroupMobileApp, and withLinkUrl() in MobileAppBuilder have been marked as deprecated and will start throwing user errors on July 1, 2015. If you use any of these methods in your script, make sure you update them to use the setFinalUrl() / withFinalUrl() methods instead.

• We have deprecated the call-only field in phone extensions. The following methods have been marked as deprecated and will start throwing user errors on June 14, 2015:

  • isCallOnly() and setCallOnly() in AdGroupPhoneNumber, CampaignPhoneNumber, and PhoneNumber
  • withCallOnly() in PhoneNumberBuilder

  If your ad extensions use the call-only feature, migrate your campaigns to call-only campaigns by following the instructions here.

May 1, 2015

• You can now access the Google Content API for Shopping through Apps Script. Guide | Code snippets

• You now have access to these account-level ad extensions: callout, mobile app, and account review. Guide

April 2, 2015

• Shopping channel and channel exclusivity are now supported in Google Ads scripts. Docs

• You can now set or clear bid strategies at the keyword level. Docs

March 10, 2015

• Upgraded URLs are now supported in Google Ads scripts. Migration guide

January 23, 2015

• Display criteria (keywords, placements, topics, audiences) are now accessible in Google Ads scripts. Docs | Code snippets

• Bidding in campaigns, ad groups, and criteria can now be managed in Google Ads scripts. Guide | Code snippets

January 12, 2015

• Bulk upload is now supported in Google Ads scripts. You can construct scripts to create, edit, and delete entities (campaigns, ad groups, keywords, ads) as well as upload offline conversions using bulk upload. Guide | Code snippets

December 11, 2014

• Introduce builders for ads and keywords, and standardize existing ad group and ad extension builders. Guide

December 2, 2014

• Integration with Advanced APIs. Guide | Code snippets

November 17, 2014

• Starting December 3, 2014, filtering behavior for the AdsManagerApp.accounts() method is changing.

November 4, 2014

• Added support for ad customizers--the latest method for dynamically altering ad content. Guide | Solution | Code snippets

• Scripts now support AdWords API v201409 reports. This version introduces PLACEHOLDER_REPORT, a new report type that allows for retrieval of extension stats.

• You can now retrieve product ads using the ads() method of ShoppingAdGroup. You can create new product ads using newAdBuilder().