预览模式

当脚本在预览模式下执行时,它们不会更改实际的广告系列数据。而是会显示如果脚本正在执行,将会进行的更改。对输出结果满意后,您可以开始实时执行脚本或安排脚本执行时间。

预览模式是一项强大的功能,您可以利用它来开发和调试脚本,而不必担心会错误地更改您的 Google Ads 数据。

预览模式仅会影响使用 AdsApp 作为入口点的调用。对其他服务的调用将照常进行。例如,如果某个脚本使用 MailApp 发送电子邮件,则无论该脚本是预览还是执行过,该脚本都会发送出去。在上述两种情况下,电子表格也会更新。脚本可以通过其执行信息了解是否正在预览模式下运行。

以下代码段将无法在预览模式下按预期运行:

// Suppose the ad group has no keywords.
let adGroup = findAnEmptyAdGroup();

// Create a keyword.
adGroup.createKeyword("test");

// Fetch all keywords in the ad group.
let keywords = adGroup.keywords().get();

// In preview mode, will log "false": keyword was not actually created.
// In real execution, will log "true".
console.log("Are there keywords in the ad group? " + keywords.hasNext());