プレビュー モード

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

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