عند تنفيذ النصوص البرمجية في وضع المعاينة، لا تُجري أي تغييرات على data الحملة الفعلية. بدلاً من ذلك، يعرض تنفيذ النص البرمجي التغييرات التي كان سيتم إجراؤها في حال تنفيذ النص البرمجي. بعد أن تكون راضيًا عن النتيجة، يمكنك بدء التنفيذ المباشر للنص البرمجي أو جدولته.
وضع المعاينة هو ميزة فعّالة، إذ يتيح لك تطوير رمز برمجي وإصلاح الأخطاء فيه بدون القلق بشأن إجراء تغييرات خاطئة على بياناتك في "إعلانات Google".
لا يؤثر وضع المعاينة إلا في المكالمات التي تستخدم AdsApp كنقطة دخول. وستستمر المكالمات إلى
الخدمات الأخرى كالمعتاد. على سبيل المثال، إذا كان نص برمجي يستخدِم MailApp لإرسال رسالة إلكترونية، سيتم إرسالها سواء تم 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());