1

Topic: Простые Триггеры. Запуск скриптов и функций

Триггеры позволить Apps Script запустить функцию автоматически , когда определенное событие, как открытие документа, происходит. Простые триггеры представляют собой набор зарезервированных функций , встроенных в Apps Script, как функция OnOpen (е) , который выполняет , когда пользователь открывает Google Docs, таблицы или формы файла. Устанавливаемые спусковые предлагают больше возможностей , чем простые триггеры , но должна быть активирована перед использование. Для обоих типов триггеров, Apps Script передает сработавшей функцию объекта события , которое содержит информацию о контексте , в котором произошло событие.


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

OnOpen (е) запускается , когда пользователь открывает электронную таблицу, документ или форму , что он или она имеет разрешение на изменение.
onEdit (е) запускается , когда пользователь изменяет значение в электронной таблице.
onInstall (е) запускается , когда пользователь устанавливает надстройки .
doGet (е) запускается , когда пользователь посещает веб - приложение или программа отправляет HTTP GET запрос на веб - приложения.
doPost (е) выполняется , когда программа отправляет HTTP POST запрос на веб - приложения.
Е параметр в именах функций выше , является объектом события , который передается функции. Объект содержит информацию о контексте , который вызвал срабатывание триггера, но использовать его не является обязательным.

2

Re: Простые Триггеры. Запуск скриптов и функций

Простые Триггеры

Триггеры позволить Apps Script запустить функцию автоматически , когда определенное событие, как открытие документа, происходит. Простые триггеры представляют собой набор зарезервированных функций , встроенных в Apps Script, как функция OnOpen (е) , который выполняет , когда пользователь открывает Google Docs, таблицы или формы файла. Устанавливаемые спусковые предлагают больше возможностей , чем простые триггеры , но должна быть активирована перед использование. Для обоих типов триггеров, Apps Script передает сработавшей функцию объекта события , которое содержит информацию о контексте , в котором произошло событие.

3

Re: Простые Триггеры. Запуск скриптов и функций

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

OnOpen (е) запускается , когда пользователь открывает электронную таблицу, документ или форму , что он или она имеет разрешение на изменение.
onEdit (е) запускается , когда пользователь изменяет значение в электронной таблице.
onInstall (е) запускается , когда пользователь устанавливает надстройки .
doGet (е) запускается , когда пользователь посещает веб - приложение или программа отправляет HTTP GET запрос на веб - приложения.
doPost (е) выполняется , когда программа отправляет HTTP POST запрос на веб - приложения.
Е параметр в именах функций выше , является объектом события , который передается функции. Объект содержит информацию о контексте , который вызвал срабатывание триггера, но использовать его не является обязательным.

4

Re: Простые Триггеры. Запуск скриптов и функций

Ограничения

Потому что простой вызывает огонь автоматически, не спрашивая пользователя для авторизации, они подлежат несколько ограничений:

Сценарий должен быть связан с файлом Простыни, Docs или форм Google.
Они не работают, если файл открыт только для чтения режиме (просмотра или комментария).
Они не могут получить доступ к услуги , которые требуют разрешения . Например, простой триггер не может отправить по электронной почте , так как служба Gmail требует авторизации, но простой триггер может перевести фразу с сервисом языка , которое является анонимным.
Они могут изменить файл они связаны, но не может получить доступ к другим файлам, потому что это требует авторизации.
Они могут или не могут быть в состоянии определить идентификатор текущего пользователя, в зависимости от сложного набора ограничений безопасности .

Они не могут работать в течение более 30 секунд.
При определенных обстоятельствах, дополнения для Google Таблиц, Docs, и формы их запуска OnOpen (е) и onEdit (е) простые триггеры в режиме не-авторизации , который представляет некоторые дополнительные осложнения. Для получения дополнительной информации см руководство по надстройки на жизненном цикле авторизации .
Эти ограничения не распространяются на doGet () или doPost () .

5

Re: Простые Триггеры. Запуск скриптов и функций

OnOpen ()

OnOpen () триггер запускается автоматически , когда пользователь открывает электронную таблицу, документ или форму , что он или она имеет разрешение на изменение. (Триггер не запускается при ответе на форме, только при открытии формы для редактирования.) OnOpen () чаще всего используется для добавления пользовательских пунктов меню в Google Docs, Sheets или форм.

function onOpen() {
  // Add a custom menu to the spreadsheet.
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
      .createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addToUi();
}

6

Re: Простые Триггеры. Запуск скриптов и функций

onEdit ()

OnEdit () триггер запускается автоматически , когда пользователь изменяет значение любой ячейки в электронной таблице. Большинство onEdit () триггеры использовать информацию , содержащуюся в объекте события , чтобы реагировать соответствующим образом . Например, onEdit (е) ниже функция задает комментарий в ячейке , которая записывает последний раз , когда он был отредактирован.

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

7

Re: Простые Триггеры. Запуск скриптов и функций

onInstall ()

OnInstall () триггер запускается автоматически , когда пользователь устанавливает надстройки . Наиболее распространенное использование onInstall () просто позвонить OnOpen () для добавления пользовательских меню. В конце концов, когда надстройка установлена, файл уже открыт, и , таким образом , OnOpen () не будет работать сам по себе , если файл не будет возобновлено.

function onInstall(e) {
  onOpen(e);
}

8

Re: Простые Триггеры. Запуск скриптов и функций

doGet () и doPost ()

DoGet () триггер запускается автоматически , когда пользователь посещает веб - приложение или программа отправляет HTTP GET запрос на веб - приложения. DoPost (е) выполняется , когда программа отправляет HTTP POST запрос на веб - приложения. Эти триггеры демонстрируются более в руководствах к веб - приложений , HTML службы и службы контента . Обратите внимание , что doGet () и doPost () не подпадают под действие ограничений , перечисленных выше.

9

Re: Простые Триггеры. Запуск скриптов и функций

Доступные типы триггеров

Если ограничения на простых триггеров держать их от удовлетворения ваших потребностей, устанавливаемая триггер может работать вместо этого. В таблице ниже приведены типы триггеров доступны для каждого типа события. Например, Google Таблицы, формы и Docs все поддерживают простые открытые триггеры, но только листы и формы поддержки открытых триггеров устанавливаемые.