وضع المعاينة

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