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 عامل تشغيل SPREADSheetsS، أو مشغل يستند إلى الوقت. ستعيد 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