Скрипт привязывается к файлу Google Sheets, Docs, Slides или Forms, если он был создан на основе этого документа, а не как отдельный скрипт . Файл, к которому прикреплен привязанный скрипт, называется «контейнером». Связанные скрипты обычно ведут себя как автономные скрипты, за исключением того, что они не отображаются на Google Диске, их нельзя отсоединить от файла, к которому они привязаны, и они получают несколько особых привилегий по отношению к родительскому файлу.
Обратите внимание, что сценарии также могут быть привязаны к Сайтам Google, но эти сценарии почти всегда развертываются как веб-приложения . Скрипты, привязанные к Таблицам, Документам, Слайдам или Формам, также могут стать веб-приложениями, хотя это необычно.
Создать связанный скрипт
Google Документы, Таблицы или Презентации
Чтобы создать связанный скрипт в Google Docs, Sheets или Slides, откройте документ в Docs, электронную таблицу в Sheets или презентацию в Slides и щелкните Extensions > Apps Script . Чтобы повторно открыть скрипт в будущем, сделайте то же самое или откройте скрипт на панели инструментов Apps Script .
Гугл формы
Чтобы создать связанный скрипт в Google Forms, откройте форму и нажмите Еще > Редактор скриптов . Чтобы повторно открыть скрипт в будущем, сделайте то же самое или откройте скрипт на панели инструментов Apps Script .
Специальные методы
Связанные скрипты могут вызывать несколько методов, которые автономные скрипты не могут:
-
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()иgetActiveForm()позволяют связанным сценариям ссылаться на их родительский файл, не обращаясь к идентификатору файла. -
getUiпозволяет связанным сценариям получать доступ к пользовательскому интерфейсу для их родительского файла, чтобы добавлять настраиваемые меню, диалоговые окна и боковые панели . - В Google Sheets
getActiveSheet(),getActiveRange()иgetActiveCell()позволяют сценарию определять текущий лист пользователя, выбранный диапазон ячеек или выбранную отдельную ячейку.setActiveSheet(sheet)иsetActiveRange(range)позволяют сценарию изменять эти выборки. - В Документах Google методы
getCursor()иgetSelection()позволяют сценарию определять положение курсора пользователя или выделенного текста.setCursor(position)иsetSelection(range)позволяют сценарию изменять эти местоположения.
Для получения дополнительной информации см. руководство по расширению Google Sheets или руководство по расширению Google Docs .
Пользовательские меню, диалоговые окна и боковые панели
Связанные скрипты могут настраивать Google Sheets, Docs и Forms, добавляя настраиваемые меню и диалоговые окна или боковые панели . Однако имейте в виду, что сценарий может взаимодействовать только с пользовательским интерфейсом для текущего экземпляра открытого файла. То есть сценарий, привязанный к одному документу, не может влиять на пользовательский интерфейс другого документа.
Дополнения
Надстройки работают внутри Gmail, Google Sheets, Docs, Slides и Forms. Если вы разработали связанный или автономный сценарий и хотите поделиться им со всем миром, Apps Script позволяет опубликовать ваш сценарий как дополнение, чтобы другие пользователи могли установить его из магазина дополнений.
Триггеры
Связанные скрипты могут использовать простые триггеры , такие как специальная onOpen() , которая запускается автоматически всякий раз, когда файл открывается пользователем, имеющим права на редактирование. Как и все типы скриптов, они также могут использовать устанавливаемые триггеры .
Пользовательские функции
Пользовательская функция — это функция в скрипте, привязанная к Google Таблицам, которую вы вызываете непосредственно из ячейки, используя синтаксис =myFunctionName() . Таким образом, пользовательские функции аналогичны сотням встроенных функций в Таблицах, таких как AVERAGE или SUM , за исключением того, что вы определяете поведение пользовательской функции.
Доступ к связанным скриптам
Только пользователи, имеющие разрешение на редактирование контейнера, могут запускать связанный с ним скрипт. Соавторы, имеющие доступ только для просмотра, не могут открыть редактор сценариев, хотя, если они сделают копию родительского файла, они станут владельцем копии и смогут просматривать и запускать копию сценария.