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:
November 27, 2018
- As part of the "AdWords" to "Google Ads" rebranding,
AdWordsApp
andMccApp
have been renamed toAdsApp
andAdsManagerApp
, 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
andgetDescription2
toExpandedTextAd
. - Added
withHeadlinePart3
andwithDescription2
toExpandedTextAdBuilder
.
- Added
Added support for working with Negative Keyword Lists in Shopping Campaigns.
- Added
negativeKeywordLists
andaddNegativeKeywordList
andremoveNegativeKeywordList
toShoppingCampaign
.
- Added
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
andwithActionHeadline
toInStreamAdBuilder
. - Added
withCpa
toVideoAdGroupBuilder
. - Added
getCpa
andsetCpa
toVideoAdGroupBidding
.
- Added
April 19, 2018
- Added
getTotalAmount
,setTotalAmount
, andgetType
methods to theBudget
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.
April 19, 2017
Added support for budget orders and user lists.
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()
andgetClickConversionRate()
have been deprecated and will sunset on February 21, 2017. Use the newgetConversions()
andgetConversionRate()
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:
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()
. GuideYou 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, andwithLinkUrl()
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 thesetFinalUrl()
/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()
andsetCallOnly()
in AdGroupPhoneNumber, CampaignPhoneNumber, and PhoneNumberwithCallOnly()
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().