Class Trigger

المشغّل

مشغّل نص برمجي

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
getEventType()EventTypeتعرِض هذه السمة نوع الحدث الذي يتم تشغيل المشغّل عند وقوعه.
getHandlerFunction()Stringتعرِض الدالة التي يتم استدعاؤها عند تشغيل المشغّل.
getTriggerSource()TriggerSourceتعرِض مصدر الأحداث التي تؤدي إلى تشغيل المشغّل.
getTriggerSourceId()Stringتعرض هذه السمة رقم التعريف الخاص بالمصدر.
getUniqueId()Stringتعرِض هذه السمة معرّفًا فريدًا يمكن استخدامه للتمييز بين المشغّلات.

مستندات تفصيلية

getEventType()

تعرِض هذه السمة نوع الحدث الذي يتم تشغيل المشغّل عند وقوعه. 

const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  if (triggers[i].getEventType() === ScriptApp.EventType.CLOCK) {
    // Some code here - other options are:
    // ScriptApp.EventType.ON_EDIT
    // ScriptApp.EventType.ON_FORM_SUBMIT
    // ScriptApp.EventType.ON_OPEN
  }
}

الإرجاع

‫EventType: نوع الحدث الذي يتم تشغيله.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/script.scriptapp

getHandlerFunction()

تعرِض الدالة التي يتم استدعاؤها عند تشغيل المشغّل. 

// Create a trigger for the script.
ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('id of my spreadsheet')
    .onEdit()
    .create();
Logger.log(ScriptApp.getProjectTriggers()[0]
               .getHandlerFunction());  // logs "myFunction"

الإرجاع

String: اسم الطريقة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/script.scriptapp

getTriggerSource()

تعرِض مصدر الأحداث التي تؤدي إلى تشغيل المشغّل.

على سبيل المثال، يعرض العامل المشغّل onEdit في جدول البيانات SPREADSHEETS، أو يعرض العامل المشغّل المستند إلى الوقت CLOCK. 

const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  if (triggers[i].getTriggerSource() === ScriptApp.TriggerSource.CLOCK) {
    Logger.log(`${triggers[i].getUniqueId()} source is clock`);
  } else if (
      triggers[i].getTriggerSource() === ScriptApp.TriggerSource.SPREADSHEETS) {
    Logger.log(`${triggers[i].getUniqueId()} source is spreadsheets`);
  }
}

الإرجاع

TriggerSource: الناشر الذي يتم تشغيل هذا الإجراء له.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/script.scriptapp

getTriggerSourceId()

تعرض هذه السمة رقم التعريف الخاص بالمصدر.

على سبيل المثال، إذا كان مصدر عامل التفعيل هو جدول بيانات، يكون هذا هو رقم تعريف جدول البيانات. بالنسبة إلى أحداث الساعة، تعرض هذه السمة القيمة null.

الإرجاع

String: رقم تعريف الكيان في الناشر الذي يمثّل هذا الإجراء مشغّلاً له.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/script.scriptapp

getUniqueId()

تعرِض هذه السمة معرّفًا فريدًا يمكن استخدامه للتمييز بين المشغّلات.

الإرجاع

String — المعرّف الفريد للمشغّل.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/script.scriptapp