טריגר לסקריפט.
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
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
– שם ה-method
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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()
מחזירה את המזהה הספציפי למקור.
לדוגמה, אם מקור הטריגר הוא גיליון אלקטרוני, זה יהיה המזהה של גיליון אלקטרוני. עבור אירועי שעון, הפונקציה מחזירה null.
חזרה
String
– מזהה הישות ב-בעל התוכן הדיגיטלי שזו טריגר עבור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/script.scriptapp
getUniqueId()
הפונקציה מחזירה מזהה ייחודי שיכול לשמש להבחנה בין טריגרים.
חזרה
String
– המזהה הייחודי של הטריגר
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/script.scriptapp