This is the legacy documentation for Google Ads scripts. Go to the current docs.

Execution Info

Stay organized with collections Save and categorize content based on your preferences.

Information about a running script

You can access certain attributes of a running script through the methods of the ExecutionInfo object. isPreview(), for instance, tells you whether a script is currently being previewed or is actually executing. This often simplifies debugging code:

// Code that generates a report.
// ...
if (!AdsApp.getExecutionInfo().isPreview()) {
  // Do not email the report when in preview mode!
  MailApp.sendEmail("customer@example.com", "Report is ready!", report);
}

Additionally, the ExecutionInfo object exposes remaining quota, allowing a script to make intelligent decisions when nearing its limits.

Information about a script's account

Account information for a running script is often needed, especially when the same unchanged script is used in multiple accounts. If the script is emailing out a report, the recipient needs to identify the originating account. You can use the Account object's getCustomerId() method for this:

var accountId = AdsApp.currentAccount().getCustomerId();
MailApp.sendEmail("customer@example.com",
    "Report is ready for " + accountId, report);

The Account object also has methods to let you identify the account's currency and time zone.