טריגר לסקריפט.
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | Event | מחזירה את סוג האירוע שהטריגר מופעל בו. |
get | String | מחזירה את הפונקציה שמופעלת כשהטריגר מופעל. |
get | Trigger | הפונקציה מחזירה את מקור האירועים שגורמים להפעלת הטריגר. |
get | String | מחזירה את המזהה הספציפי למקור. |
get | String | הפונקציה מחזירה מזהה ייחודי שאפשר להשתמש בו כדי להבחין בין טריגרים שונים. |
תיעוד מפורט
get Event Type()
מחזירה את סוג האירוע שהטריגר מופעל בו.
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 } }
חזרה
Event – סוג האירוע שהטריגר הזה מיועד לו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/script.scriptapp
get Handler Function()
מחזירה את הפונקציה שמופעלת כשהטריגר מופעל.
// 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 – שם ה-method.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/script.scriptapp
get Trigger Source()
הפונקציה מחזירה את מקור האירועים שגורמים להפעלת הטריגר.
לדוגמה, טריגר מסוג 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`); } }
חזרה
Trigger – בעל התוכן הדיגיטלי שעבורו מוגדר הטריגר.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/script.scriptapp
get Trigger Source Id()
מחזירה את המזהה הספציפי למקור.
לדוגמה, אם מקור הטריגר הוא גיליון אלקטרוני, זהו המזהה של הגיליון האלקטרוני. לאירועים של שעון, הפונקציה מחזירה null.
חזרה
String — המזהה של הישות בבעל התוכן הדיגיטלי שעבורה מוגדר הטריגר הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/script.scriptapp
get Unique Id()
הפונקציה מחזירה מזהה ייחודי שאפשר להשתמש בו כדי להבחין בין טריגרים שונים.
חזרה
String – המזהה הייחודי של הטריגר.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/script.scriptapp