プレビュー モード

スクリプトがプレビュー モードで実行される場合、実際のキャンペーン データは変更されません。代わりに、スクリプトが実行された場合に実行されるはずだった変更がスクリプトの実行に表示されます。出力に満足したら、スクリプトのライブ実行を開始するか、スケジュールを設定できます。

プレビュー モードは、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, 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());