Class TriggerBuilder

TriggerBuilder

Универсальный конструктор для запуска скриптов.

Методы

Метод Тип возвращаемого значения Краткое описание
for Document(document) Document Trigger Builder Создает и возвращает Document Trigger Builder связанный с заданным документом.
for Document(key) Document Trigger Builder Создает и возвращает Document Trigger Builder связанный с документом, имеющим заданный ID.
for Form(form) Form Trigger Builder Создает и возвращает Form Trigger Builder , привязанный к заданной форме.
for Form(key) Form Trigger Builder Создает и возвращает Form Trigger Builder , связанный с формой, имеющей заданный идентификатор.
for Spreadsheet(sheet) Spreadsheet Trigger Builder Создает и возвращает Spreadsheet Trigger Builder , привязанный к заданной электронной таблице.
for Spreadsheet(key) Spreadsheet Trigger Builder Создает и возвращает Spreadsheet Trigger Builder связанный с электронной таблицей с заданным идентификатором.
for User Calendar(emailId) Calendar Trigger Builder Возвращает конструктор для создания триггеров календаря.
time Based() Clock Trigger Builder Создает и возвращает Clock Trigger Builder для построения триггеров, срабатывающих по времени.

Подробная документация

forDocument(document)

Создает и возвращает объект DocumentTriggerBuilder связанный с заданным документом.

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

Параметры

Имя Тип Описание
document Document Документ.

Возвращаться

DocumentTriggerBuilder — Новый DocumentTriggerBuilder.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

forDocument(key)

Создает и возвращает объект DocumentTriggerBuilder связанный с документом, имеющим заданный ID.

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

Параметры

Имя Тип Описание
key String Идентификатор документа.

Возвращаться

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();

Параметры

Имя Тип Описание
form Form Форма.

Возвращаться

FormTriggerBuilder — Новый FormTriggerBuilder.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

forForm(key)

Создает и возвращает объект FormTriggerBuilder связанный с формой, имеющей заданный ID.

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

Параметры

Имя Тип Описание
key String Идентификатор формы.

Возвращаться

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();

Параметры

Имя Тип Описание
sheet Spreadsheet Электронная таблица.

Возвращаться

SpreadsheetTriggerBuilder — Новый SpreadsheetTriggerBuilder.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

forSpreadsheet(key)

Создает и возвращает объект SpreadsheetTriggerBuilder связанный с электронной таблицей, имеющей заданный ID.

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

Параметры

Имя Тип Описание
key String Идентификатор электронной таблицы.

Возвращаться

SpreadsheetTriggerBuilder — Новый SpreadsheetTriggerBuilder.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

forUserCalendar(emailId)

Возвращает конструктор для создания триггеров календаря.

Параметры

Имя Тип Описание
email Id String Адрес электронной почты пользователя, чей календарь отслеживается триггером.

Возвращаться

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 — Новый ClockTriggerBuilder.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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