Class Trigger

عامل التفعيل

مشغِّل النص البرمجي.

الطُرق

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

الوثائق التفصيلية

getEventType()

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

var triggers = ScriptApp.getProjectTriggers();
for (var 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. 

var triggers = ScriptApp.getProjectTriggers();
for (var 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()

تعرض المعرّف الخاص بالمصدر.

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

استرجاع الكرة

String: رقم تعريف الكيان في الناشر الذي يؤدي إلى تشغيل هذا الكيان

التفويض

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

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

getUniqueId()

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

استرجاع الكرة

String: المعرّف الفريد للعامل المشغِّل

التفويض

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

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