Damien Gonot
Home Blog Notes About

A Brief Introduction to Google Ads Scripts

written on 2018-03-08

What are Google Ads scripts?

Google Ads scripts is a way to automate Google Ads campaigns by using a slightly modified version of JavaScript to read, create, update and delete Google Ads “entities” (campaigns, ad groups, keywords, ads…). Google Ads scripts are hosted directly inside Google Ads and you don’t need a server to run them, Google Ads takes care of everything for you.

Let’s create our first Google Ads script now!

How to access it?

Using the new Google Ads interface

The easiest way is to take advantage of Google Ads’ new shortcut feature: by typing gt anywhere in the interface. After the search prompt appears, simply search for “scripts” and press Enter. Result of gt script

Or going through the actual interface menus, click on the wrench icon in the top-right corner and you’ll find “Scripts” in the “Bulk actions” section. Actual interface

Using the old Google Ads interface

If you’re not using the new Google Ads interface, you can find Scripts in the left-hand side menu under the “Bulk operations” section. Old interface

I’ll use the newer Google Ads interface out of convenience for the rest of the tutorial.

Our first Google Ads script

If you’ve never used Google Ads scripts before, your list of scripts should be empty. You can create a first one by clicking on the big circled “+” button. Circled plus button This is what you should see: Empty AdWords Script You can name it however you want. I will name mine “Our first AdWords Script”. An asterisk (*) before the script name indicates that there are unsaved changes.

You can ignore the “Advanced APIs” button for now as it is used only to connect to other Google Services like BigQuery etc…

That big scary warning on a yellow background is letting us know we need to authorize the script before it can take actions on our Google Ads account. It is safe to go ahead and authorize it now as our script is not doing anything yet. We might need to re-authorize it in the future if we connect the script to read/write data to Google Spreadsheets for example.

Below that is a big (almost) empty canvas where magic will happen.

function main() {

We must write code inside the main() function for it to run. It is customary to try a new programming language/interface by writing a “Hello, World!” program that simply prints Hello, World!. In a normal JavaScript application, this would be console.log("Hello, World!"); but because Google Ads scripts is a bit different from JavaScript, our program becomes Logger.log("Hello, World!");. Please note that single quotes (') can be used instead of double quotes ("), it is just a matter of personal preferences. I will use single quotes for the rest of the tutorial because this is what I prefer.

Here is what you should have now:

function main() {
  Logger.log('Hello, World!');

You can go ahead and press the Preview button. It will automatically save your script and run it in preview mode. When scripts are run in “Preview”, they don’t actually run against your Google Ads account and don’t make any changes yet. Only when you press the Run button your scripts will modify the actual Google Ads account. For now, we’ll only use Preview.

You’ll see that the Changes section stays empty. That’s because we haven’t done any actions on our Google Ads entities yet and have only played with the Logs. So click on the Logs section and this is what you should see: Hello world first result

Congrats! You’ve run your first Google Ads script!

You can continue learning more about Google Ads scripts by reading my next article: Google Ads Scripts: Reading Data.