プレビュー モード

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

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