وضع المعاينة

عند تنفيذ النصوص البرمجية في وضع المعاينة، لا تُجري أي تغييرات على 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());