Расширьте возможности Google Таблиц с помощью надстроек.

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

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

Вы можете посмотреть созданные другими пользователями надстройки для Google Sheets на торговой площадке Google Workspace Marketplace .

Что вы можете сделать

Вот несколько примеров того, что можно сделать с помощью дополнений, расширяющих функциональность Google Sheets:

Надстройки для Google Sheets создаются с использованием Apps Script. Чтобы узнать больше о том, как получить доступ к Google Sheets и управлять им с помощью Apps Script, см. раздел «Расширение возможностей Google Sheets» .

Структура листа

Электронная таблица Sheets состоит из одного или нескольких листов. Каждый лист представляет собой, по сути, двумерную сетку ячеек, в которые можно помещать текст, числа, ссылки или другие значения. Группа из одной или нескольких смежных ячеек называется диапазоном .

Сервис Apps Script для работы с электронными таблицами предоставляет несколько классов для представления организационных структур в таблицах (например, Sheet и Range »). Вы можете использовать эти классы для чтения и изменения данных и поведения таблиц.

Триггеры

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

Дополнительную информацию о том, какие триггеры можно использовать с надстройками Sheets и какие ограничения применяются к их использованию, см. в разделе «Триггеры надстроек».

Пользовательские функции

В Google Sheets есть ряд встроенных функций, таких как SUM и AVERAGE , которые можно вызывать из ячейки Sheets. Надстройки для Sheets позволяют определять дополнительные пользовательские функции в дополнение к этим встроенным функциям. После установки надстройки пользователем все определенные пользовательские функции, включенные в нее, становятся доступны немедленно. Надстройка может состоять только из определений пользовательских функций. Определения пользовательских функций, как правило, передаются другим пользователям путем публикации надстройки, содержащей эти определения.

Создание дополнительных пользовательских функций

Любая функция, определенная в проекте скрипта дополнения, может быть использована в качестве пользовательской функции. После реализации функции и установки дополнения вы можете вызвать пользовательскую функцию, как и любую другую встроенную функцию Google Sheets: в ячейке листа введите знак равенства ( = , за которым следует имя функции и необходимые параметры. Если ошибок нет, результат, возвращаемый функцией, помещается в ячейку листа, при необходимости перетекая в соседние ячейки.

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

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

  • When naming your function, try to create a unique name, perhaps related to the name of your add-on. If two or more installed add-ons define custom functions with the same name, users can only use one of them.
  • Ваше дополнение должно четко указывать, какие пользовательские функции оно предоставляет. Обязательно предоставьте точные JSDoc-комментарии для ваших пользовательских функций, чтобы Apps Script мог отображать информацию для автозаполнения пользователю. Кроме того, рассмотрите возможность предоставления дополнительной документации по пользовательским функциям либо в самом дополнении, либо на странице поддержки дополнения.
  • Пользовательские функции, которые не завершаются менее чем за 30 секунд, завершаются с Internal error executing the custom function . Для обеспечения удобства использования ограничьте объем вычислений в пользовательской функции. Оптимизируйте функцию там, где это возможно.
  • Пользовательские функции не могут использовать службы Apps Script, требующие авторизации, и при попытке это сделать выдают ошибку You do not have permission to call X service . Используйте в своей пользовательской функции только разрешенные службы .
  • Каждая пользовательская функция в таблице приводит к отдельному вызову серверов Apps Script. Если пользователь попытается использовать пользовательские функции в слишком большом количестве ячеек, их выполнение может замедлиться. Чтобы этого избежать, делайте пользовательские функции максимально простыми. Если вам нужна функция для выполнения сложной или длительной обработки, не используйте пользовательскую функцию — предоставьте эту функциональность с помощью пункта меню, диалогового окна или взаимодействия в боковой панели.

Макросы в таблицах

Макросы позволяют записывать действия, выполняемые в таблицах, и повторять их позже с помощью сочетания клавиш. При создании макроса в таблице он добавляется в качестве макрофункции в проект Apps Script, привязанный к этой таблице. Дополнительную информацию о макросах см. в разделе «Макросы в таблицах» .

К сожалению, макросы для Google Sheets нельзя распространять вместе с надстройками. Если вы включите определение макроса в манифест надстройки, оно станет недоступно пользователям этой надстройки.