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