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