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