وضع المعاينة

عند تنفيذ البرامج النصية في وضع المعاينة، لا تُجري أي تغييرات على بيانات الحملة الفعلية. بدلاً من ذلك، يعرض تنفيذ النص البرمجي التغييرات التي كان من المفترض إجراؤها إذا كان النص البرمجي قيد التنفيذ. بعد التأكّد من صحة الناتج، يمكنك بدء التنفيذ المباشر لبرنامج نصي أو تحديد موعد له.

تُعدّ "وضع المعاينة" ميزة فعّالة، لأنّها تتيح لك تطوير نص برمجي وتصحيح أخطائه بدون القلق بشأن إجراء تغييرات خاطئة على بياناتك في "إعلانات Google".

لا يؤثّر وضع المعاينة إلا في المكالمات التي تستخدم 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());