スクリプトをプレビュー モードで実行しても、実際のキャンペーン データは変更されません。代わりに、スクリプトが実行された場合に行われるはずだった 変更がスクリプトの実行結果に表示されます。出力に問題がなければ、スクリプトのライブ実行を開始するか、スケジュールを設定できます。
プレビュー モードは、Google 広告データに誤った変更が加えられることを心配せずにスクリプトを開発してデバッグできるため、非常に便利な機能です。
プレビュー モードは、エントリ ポイントとして 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, this will log "false" since the keyword was not actually created.
// In real execution, this will log "true".
console.log("Are there keywords in the ad group? " + keywords.hasNext());