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

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

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