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 – שם ה-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