مشغِّل النص البرمجي.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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