Объекты событий

Простые и устанавливаемые триггеры позволяют Apps Script автоматически запускать функцию при возникновении определенного события. Когда срабатывает триггер, Apps Script передает функции объект события в качестве аргумента, обычно называемого e . Объект события содержит информацию о контексте, вызвавшем срабатывание триггера. Например, в приведенном ниже примере кода показан простой триггер onEdit(e) для сценария Google Sheets, который использует объект события для определения того, какая ячейка была отредактирована.

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

На этой странице подробно описаны поля объекта события для различных типов триггеров.

События, создаваемые устанавливаемыми триггерами, содержат triggerUid идентифицирующий триггер, вызвавший событие. Это полезно для сценариев, имеющих несколько устанавливаемых триггеров.

События Google Таблиц

Различные триггеры, специфичные для Google Таблиц, позволяют сценариям реагировать на действия пользователя в электронной таблице.

Открыть ( простой и устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . LIMITED
source	Объект Spreadsheet , представляющий файл Google Sheets, к которому привязан скрипт. Spreadsheet
triggerUid	Идентификатор триггера, вызвавшего это событие (только для устанавливаемых триггеров). 4034124084959907503
user	Объект User , представляющий активного пользователя, если он доступен ( в зависимости от сложного набора ограничений безопасности ). [e-mail]

Изменять ( устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . FULL
changeType	Тип изменения ( EDIT , INSERT_ROW , INSERT_COLUMN , REMOVE_ROW , REMOVE_COLUMN , INSERT_GRID , REMOVE_GRID , FORMAT или OTHER ). INSERT_ROW
source	Объект Spreadsheet , представляющий файл Google Sheets, к которому привязан скрипт. Spreadsheet
triggerUid	Идентификатор триггера, вызвавшего это событие. 4034124084959907503
user	Объект User , представляющий активного пользователя, если он доступен ( в зависимости от сложного набора ограничений безопасности ). [e-mail]

Редактировать ( простой и устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . LIMITED
oldValue	Значение ячейки до редактирования, если таковое имеется. Доступно только в том случае, если редактируемый диапазон представляет собой одну ячейку. Будет неопределенным, если в ячейке не было предыдущего содержимого. 1234
range	Объект Range , представляющий редактируемую ячейку или диапазон ячеек. Range
source	Объект Spreadsheet , представляющий файл Google Sheets, к которому привязан скрипт. Spreadsheet
triggerUid	Идентификатор триггера, вызвавшего это событие (только для устанавливаемых триггеров). 4034124084959907503
user	Объект User , представляющий активного пользователя, если он доступен ( в зависимости от сложного набора ограничений безопасности ). [e-mail]
value	Новое значение ячейки после редактирования. Доступно только в том случае, если редактируемый диапазон представляет собой одну ячейку. 10

Отправка формы ( устанавливаемый )
Внимание: убедитесь, что вы используете этот триггер отправки формы с SpreadsheetTriggerBuilder .
authMode	Значение из перечисления ScriptApp.AuthMode . FULL
namedValues	Объект, содержащий имена и значения вопросов из отправки формы. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	Объект Range , представляющий редактируемую ячейку или диапазон ячеек. Range
triggerUid	Идентификатор триггера, вызвавшего это событие. 4034124084959907503
values	Массив со значениями в том же порядке, в котором они указаны в электронной таблице. ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Мероприятия Документов Google

Триггеры позволяют Документам Google реагировать, когда пользователь открывает документ.

Открыть ( простой и устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . LIMITED
source	Объект Document , представляющий файл Документов Google, к которому привязан скрипт. Document
triggerUid	Идентификатор триггера, вызвавшего это событие (только для устанавливаемых триггеров). 4034124084959907503
user	Объект User , представляющий активного пользователя, если он доступен ( в зависимости от сложного набора ограничений безопасности ). [e-mail]

Мероприятия Google Презентации

Триггеры позволяют Google Slides реагировать, когда пользователь открывает презентацию.

Открыть ( простой )
authMode	Значение из перечисления ScriptApp.AuthMode . LIMITED
source	Объект Presentation , представляющий файл Google Slides, к которому привязан скрипт. Presentation
user	Объект User , представляющий активного пользователя, если он доступен ( в зависимости от сложного набора ограничений безопасности ). [e-mail]

События Google Форм

Триггеры, специфичные для Google Forms, позволяют сценариям реагировать, когда пользователь редактирует форму или отправляет ответ.

Открыть * ( простой и устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . LIMITED
source	Объект Form , представляющий файл Google Forms, к которому привязан скрипт. Form
triggerUid	Идентификатор триггера, вызвавшего это событие (только для устанавливаемых триггеров). 4034124084959907503
user	Объект User , представляющий активного пользователя, если он доступен ( в зависимости от сложного набора ограничений безопасности ). [e-mail]

* Это событие происходит не тогда, когда пользователь открывает форму для ответа, а когда редактор открывает форму, чтобы изменить ее.

Отправка формы ( устанавливаемый )
Внимание: убедитесь, что вы используете этот триггер отправки формы с FormTriggerBuilder .
authMode	Значение из перечисления ScriptApp.AuthMode . FULL
response	Объект FormResponse , представляющий ответ пользователя на форму в целом. FormResponse
source	Объект Form , представляющий файл Google Forms, к которому привязан скрипт. Form
triggerUid	Идентификатор триггера, вызвавшего это событие. 4034124084959907503

События Календаря Google

Триггеры календаря срабатывают, когда события календаря пользователя обновляются (создаются, редактируются или удаляются).

Эти триггеры не сообщают вам, какое событие изменилось или как оно изменилось. Вместо этого они указывают, что вашему коду необходимо выполнить операцию добавочной синхронизации, чтобы получить последние изменения в календаре. Полное описание этой процедуры см. в руководстве Синхронизация ресурсов для Calendar API .

Чтобы синхронизировать с Календарем в Apps Script, выполните следующие действия:

1. Включите расширенную службу календаря для проекта сценария. Встроенной службы календаря недостаточно для этого рабочего процесса.
2. Определите, какие календари следует синхронизировать. Для каждого такого календаря выполните первоначальную операцию синхронизации с помощью метода Events.list() расширенной службы календаря.
3. Результат начальной синхронизации возвращает nextSyncToken для этого календаря. Сохраните этот токен для дальнейшего использования.
4. Когда срабатывает триггер Apps Script EventUpdated указывающий на изменение события календаря, выполните добавочную синхронизацию для затронутого календаря, используя сохраненный nextSyncToken . По сути, это еще один запрос Events.list() , но предоставление nextSyncToken ограничивает ответ только событиями, которые изменились с момента последней синхронизации.
5. Изучите ответ синхронизации, чтобы узнать, какие события были обновлены, и отреагировать соответствующим образом. Например, вы можете зарегистрировать изменение, обновить электронную таблицу, отправить уведомления по электронной почте или выполнить другие действия.
6. Обновите nextSyncToken который вы сохранили для этого календаря, на тот, который возвращается по запросу добавочной синхронизации. Это заставляет следующую операцию синхронизации возвращать только самые последние изменения.

Внимание: иногда токены синхронизации становятся недействительными сервером, что приводит к ошибке 410 . Когда это произойдет, ваш код должен провести полную синхронизацию и заменить все сохраненные синхронизированные данные и токены, которые у вас есть для этого календаря.

СобытиеОбновлено ( устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . FULL
calendarId	Строковый идентификатор календаря, в котором произошло обновление события. [e-mail]
triggerUid	Идентификатор триггера, вызвавшего это событие. 4034124084959907503

Мероприятия по дополнению Google Workspace

Триггер onInstall() запускается автоматически, когда пользователь устанавливает надстройку .

Установить ( простой )
authMode	Значение из перечисления ScriptApp.AuthMode . FULL

События приложения Google Chat

Дополнительные сведения об объектах событий в Google Chat см. в разделе Получение и ответ на взаимодействие с вашим приложением Google Chat .

События, управляемые временем

Триггеры, управляемые временем (также называемые триггерами часов), позволяют сценариям выполняться в определенное время или через повторяющийся интервал.

Управляемый временем ( устанавливаемый )
authMode	Значение из перечисления ScriptApp.AuthMode . FULL
day-of-month	От 1 до 31 . Поскольку имя этого свойства содержит дефисы, доступ к нему должен осуществляться через e['day-of-month'] а не через точку. 31
day-of-week	С 1 (понедельник) до 7 (воскресенье). Поскольку имя этого свойства содержит дефисы, доступ к нему должен осуществляться через e['day-of-week'] а не через точку. 7
hour	От 0 до 23 . 23
minute	От 0 до 59 . 59
month	От 1 до 12 . 12
second	От 0 до 59 . 59
timezone	Часовой пояс. UTC
triggerUid	Идентификатор триггера, вызвавшего это событие. 4034124084959907503
week-of-year	От 1 до 52 . Поскольку имя этого свойства содержит дефисы, доступ к нему должен осуществляться через e['week-of-year'] а не через точку. 52
year	Год. 2015