وقتی اسکریپتها در حالت پیشنمایش اجرا میشوند، هیچ تغییری در دادههای واقعی کمپین ایجاد نمیکنند. در عوض، اجرای اسکریپت تغییراتی را که در صورت اجرای اسکریپت ایجاد میشد، نشان میدهد. پس از رضایت از خروجی، میتوانید اجرای زنده یک اسکریپت را شروع کنید یا آن را زمانبندی کنید.
حالت پیشنمایش یک ویژگی قدرتمند است، زیرا به شما امکان میدهد بدون نگرانی در مورد تغییرات نادرست در دادههای 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, 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());