وضع المعاينة

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

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