حالت پیش نمایش

وقتی اسکریپت ها در حالت پیش نمایش اجرا می شوند، هیچ تغییری در داده های کمپین واقعی ایجاد نمی کنند. در عوض، اجرای اسکریپت تغییراتی را نشان می‌دهد که اگر اسکریپت در حال اجرا بود، ایجاد می‌شد . پس از رضایت از خروجی، می توانید اجرای زنده یک اسکریپت را شروع کنید یا آن را زمان بندی کنید.

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