سجلات التنفيذ

تعرِض نصوص "إعلانات Google" البرمجية نوعَين من سجلّات التنفيذ، سواء في وضع المعاينة أو في عمليات التنفيذ الفعلية: سجلّات التغييرات وإخراج السجلّات.

سجلّ التغييرات

تعرِض سجلّات التغييرات جميع التغييرات التي أجراها الرمز البرمجي على كيانات "إعلانات Google": وصف الكيان ونوع التغيير والقيمة قبل التغيير وبعده والأخطاء (إن وُجدت):

لقطة شاشة لشاشة المعاينة

يمكن فلترة سجلّات التغييرات بشكل إضافي لعرض الأخطاء فقط.

مخرجات السجلّات

في حال تنفيذ console.log("Hello world!"); في نص برمجي، ستظهر العبارة "مرحبًا عالمي" في السجلات. إنّ تسجيل أجزاء من النص مفيد بشكل خاص أثناء تصحيح الأخطاء، ولكنه يكون مفيدًا أيضًا في كثير من الأحيان أثناء عمليات التنفيذ المباشرة. لنفترض أنّه تم جدولة النص البرمجي التالي ليتم تنفيذه يوميًا:

let spreadsheet = SpreadsheetApp.create("Daily Report");
// Populate the spreadsheet.
// ...
console.log("Daily report ready!");
console.log(spreadsheet.getUrl());

في كل عملية تنفيذ، يسجِّل النص البرمجي عنوان URL لجدول البيانات الذي تم إنشاؤه حديثًا، ما يسهّل العثور عليه لاحقًا. يمكنك أيضًا استخدام console.warn() أو console.error() لتسجيل نص برتقالي أو أحمر في السجلات.

بالإضافة إلى رسائل السجلّ التي يحدّدها المبرمج، ستظهر أيضًا في سجلّات النصوص الأخطاء والتحذيرات التي تواجهها نصوص "إعلانات Google" البرمجية أثناء التنفيذ.