Class TriggerBuilder

TriggerBuilder

כלי כללי לטריגרים של סקריפטים.

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
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מחזירה כלי לבניית טריגרים של יומן.
timeBased()ClockTriggerBuilderהפונקציה יוצרת ומחזירה ClockTriggerBuilder לבניית טריגרים מבוססי-זמן.

תיעוד מפורט

forDocument(document)

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

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

פרמטרים

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

החזרות

DocumentTriggerBuilder - הקובץ החדש 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 - הקובץ החדש 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 – ה-sheetTriggerBuilder החדש

הרשאות

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

  • 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 – ה-sheetTriggerBuilder החדש

הרשאות

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

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

forUserCalendar(emailId)

מחזירה כלי לבניית טריגרים של יומן.

פרמטרים

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

החזרות

CalendarTriggerBuilder – הגרסה החדשה של 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 – שעון השעון החדש של ClientTriggerBuilder

הרשאות

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

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