Class TriggerBuilder

TriggerBuilder

‫builder גנרי לטריגרים של סקריפטים.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
forDocument(document)DocumentTriggerBuilderיוצר ומחזיר DocumentTriggerBuilder שמשויך למסמך הנתון.
forDocument(key)DocumentTriggerBuilderיוצרת ומחזירה DocumentTriggerBuilder שמשויך למסמך עם המזהה הנתון.
forForm(form)FormTriggerBuilderיוצרת ומחזירה FormTriggerBuilder שקשור לטופס הנתון.
forForm(key)FormTriggerBuilderיוצרת ומחזירה FormTriggerBuilder שמשויך לטופס עם המזהה הנתון.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderהפונקציה יוצרת ומחזירה אובייקט SpreadsheetTriggerBuilder שקשור לגיליון האלקטרוני שצוין.
forSpreadsheet(key)SpreadsheetTriggerBuilderיוצרת ומחזירה SpreadsheetTriggerBuilder שקשור לגיליון האלקטרוני עם המזהה שצוין.
forUserCalendar(emailId)CalendarTriggerBuilderמחזירה builder ליצירת טריגרים של יומן.
timeBased()ClockTriggerBuilderיוצרת ומחזירה ClockTriggerBuilder ליצירת טריגרים מבוססי-זמן.

תיעוד מפורט

forDocument(document)

יוצר ומחזיר DocumentTriggerBuilder שמשויך למסמך הנתון. 

ScriptApp.newTrigger('myFunction')
    .forDocument(DocumentApp.getActiveDocument())
    .onOpen()
    .create();

פרמטרים

שםסוגתיאור
documentDocumentהמסמך.

חזרה

‫DocumentTriggerBuilder — The new DocumentTriggerBuilder.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forDocument(key)

יוצרת ומחזירה DocumentTriggerBuilder שמשויך למסמך עם המזהה הנתון. 

ScriptApp.newTrigger('myFunction')
    .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
    .onOpen()
    .create();

פרמטרים

שםסוגתיאור
keyStringהמזהה של המסמך.

חזרה

‫DocumentTriggerBuilder — The new DocumentTriggerBuilder.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forForm(form)

יוצרת ומחזירה FormTriggerBuilder שקשור לטופס הנתון. 

ScriptApp.newTrigger('myFunction')
    .forForm(FormApp.getActiveForm())
    .onFormSubmit()
    .create();

פרמטרים

שםסוגתיאור
formFormהטופס.

חזרה

‫FormTriggerBuilder — האובייקט החדש FormTriggerBuilder.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forForm(key)

יוצרת ומחזירה FormTriggerBuilder שמשויך לטופס עם המזהה הנתון. 

ScriptApp.newTrigger('myFunction')
    .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
    .onFormSubmit()
    .create();

פרמטרים

שםסוגתיאור
keyStringהמזהה של הטופס.

חזרה

‫FormTriggerBuilder — האובייקט החדש FormTriggerBuilder.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forSpreadsheet(sheet)

הפונקציה יוצרת ומחזירה אובייקט SpreadsheetTriggerBuilder שקשור לגיליון האלקטרוני שצוין. 

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();

פרמטרים

שםסוגתיאור
sheetSpreadsheetהגיליון האלקטרוני.

חזרה

‫SpreadsheetTriggerBuilder — SpreadsheetTriggerBuilder החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forSpreadsheet(key)

יוצרת ומחזירה SpreadsheetTriggerBuilder שקשור לגיליון האלקטרוני עם המזהה שצוין. 

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
    .onEdit()
    .create();

פרמטרים

שםסוגתיאור
keyStringהמזהה של הגיליון האלקטרוני.

חזרה

‫SpreadsheetTriggerBuilder — SpreadsheetTriggerBuilder החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forUserCalendar(emailId)

מחזירה builder ליצירת טריגרים של יומן.

פרמטרים

שםסוגתיאור
emailIdStringמזהה האימייל של היומן של המשתמש שהטריגר עוקב אחריו.

חזרה

‫CalendarTriggerBuilder — The new CalendarTriggerBuilder.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.readonly
  • https://www.google.com/calendar/feeds

timeBased()

יוצרת ומחזירה ClockTriggerBuilder ליצירת טריגרים מבוססי-זמן. 

ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 10, 31).create();

חזרה

‫ClockTriggerBuilder — ClockTriggerBuilder החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/script.scriptapp