Today we’re launching support for responsive video ads in Google Ads scripts. If you were using the TrueView for action campaign type, you must update your code to use the new video ad type. If you don’t update, your code will begin throwing errors starting approximately October 10, 2021. The old TrueView for action campaign type is being renamed to Video action campaign along with this change.

You can update your selectors with a new withCondition clause to separate Video action campaigns from other video campaign types in your code.

To get campaigns with the video action type:

AdsApp.videoCampaigns()
    .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
    .get();

Or to get video campaigns of other types, which are unaffected by this change:

AdsApp.videoCampaigns()
    .withCondition("AdvertisingChannelSubType != VIDEO_ACTION")
    .get();

Once you've identified that you're acting on a Video action campaign, create a new type of ad group that can house responsive video ads, and then construct a new type of ad at ad creation time. For other types of video campaigns, this new ad type isn’t available.

For creating the ad group, if you were using:

videoCampaign.newVideoAdGroupBuilder().withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")

Then update that code to:

videoCampaign.newVideoAdGroupBuilder().withAdGroupType("VIDEO_RESPONSIVE")

For creating the ads themselves, if you were using:

adGroup.newVideoAd().inStreamAdBuilder()

Then update that code to:

adGroup.newVideoAd().responsiveVideoAdBuilder()

Check out the reference documentation for the new responsiveVideoAdBuilder for details on its fields and methods.

If you have any questions, please leave a post on our forum so that we can help.
- Mike Cloonan, Google Ads Scripts Team

Today we’re launching the beta version of the new Google Ads scripts experience. Existing scripts won’t be affected, but if you're interested in trying some new features and performance improvements, you can opt in on an individual script basis. To do so, open your script and switch on the new scripts experience (Beta) toggle above the code:

The code works on the same interface you've been using all along, so your existing scripts will be compatible with minimal changes.

Some highlight features include:

• Support for ES6, including let, classes, for..of loops, and more.
• Improved throughput, meaning you can process more entities in the same amount of time. We've also removed the entity limits on processing, although time limits remain in place.
• More control over setting up and maintaining bidding strategies.

The beta doesn’t currently support manager account scripts or bulk uploads, but watch out for those features in a future update.

See our developers site for full information on the new experience, including migration information, performance improvements, and updated best practices.

If you have any questions or feedback regarding the new experience, please leave a post on our forum so that we can help.
- Mike Cloonan, Google Ads Scripts Team

We have just launched a new backend for bulk uploads in Google Ads Scripts. Starting today, you can opt into the new experience by specifying the useLegacyUploads flag when creating a new bulk upload:

var upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {useLegacyUploads: false});

For now, if you don't specify a value, the default will be true, which will result in no change of behavior from before this feature. Starting on July 12, 2021 we will change the default to false, but you can still opt out for a time by explicitly passing useLegacyUploads as true. On February 1, 2022, we will disable the use of legacy uploads altogether.

We have tried to make the changes here as backwards-compatible as possible, so in most cases your existing uploads should continue to work fine even on the new backend. However, creating video ads which specify a media ID will cease working on the legacy uploads on or after July 12, when we change the default, so if those are important fields to you, make sure you do not manually override to use legacy uploads.

The new backend is exactly compatible with UI-based bulk uploads, which is an improvement over the existing bulk upload system where many columns have different names. This should make it significantly easier to set up bulk uploads by basing the format from the UI. Additionally, a few new features are available, including label manipulation and updating manager accounts.

If you have any questions, please leave a post on our forum so that we can help.
- Mike Cloonan, Google Ads Scripts Team

In the coming weeks, we'll be changing how we update the default reporting version for search and report requests that use the Google Ads Query Language in Google Ads scripts. This will allow you access to new reporting features as they are released, rather than our previous cadence of holding off on new versions for up to a few months. If you are still using AdWords API based reporting in v201809, these changes will not affect you.

We will be updating the default reporting version for Google Ads API-backed reports to use the newest version of the Google Ads API within two weeks of that version's release. So for example, whenever v8 releases, we will be updating the default reporting version for report calls using GAQL, and all search calls, to use v8 within two weeks of that time.

If you think that this may negatively affect your scripts, and you want to pin to a specific version, you can still manually specify a version which will override the default and will not update until you are ready to move on to the next version. If you do this, be on the lookout for when Google Ads API sunsets versions, because that will cause your scripts to fail until you update to a newer version. Here are examples of setting an API version.

For reports:

var report = AdsApp.report(query, {apiVersion: 'v7'});

For search:

var results = AdsApp.search(query, {apiVersion: 'v7'});

As part of this rollout, we will be updating the default (which is currently v5) to v7 shortly after this post. You can find a full list of reporting upgrades made in v6 and v7 on the Google Ads API release notes page.

If you have any questions, please leave a post on our forum so that we can help.
- Mike Cloonan, Google Ads Scripts Team