Библиотеки скриптов

Библиотека хранит общий код рабочего пространства. Одну и ту же функцию, например расчёт скидки или отправку отчёта, удобно написать один раз и вызывать из скриптов разных таблиц.

Создать библиотеку

1. Откройте раздел «Автоматизация» в левом меню и вкладку «Библиотеки».
2. Нажмите «Новая библиотека» и задайте имя: латинские буквы, цифры и знак подчёркивания, до 40 знаков, например utils.
3. Напишите код:

function discount(sum) {
  return sum >= 10000 ? 0.1 : 0;
}

function money(value) {
  return Utilities.formatNumber(value, { currency: "RUB" });
}

Скрипту доступны функции и значения, объявленные в библиотеке с начала строки (без отступа).

Подключить в скрипте

function main() {
  const utils = Library.use("utils");
  const sum = 12500;
  console.log(utils.money(sum * (1 - utils.discount(sum))));
}

Имя библиотеки пишется строкой прямо в вызове Library.use. При сохранении кода скрипт сам подключает библиотеки с этими именами из своего рабочего пространства.

Версии

• Сохранение библиотеки создаёт новую версию. Правки одного автора в течение 10 минут объединяются в одну версию, пока её не подключил ни один скрипт. Хранятся последние 200 версий.
• Скрипт работает с той версией библиотеки, которую взял при сохранении. Изменения библиотеки не ломают работающие скрипты.
• Когда выходит новая версия, над кодом скрипта появляется сообщение «У библиотеки есть новая версия» и кнопка «Обновить».
• На вкладке «Скрипты» библиотеки видно, какие скрипты её подключают и с какой версией. Кнопка «Обновить в моих скриптах» переводит на последнюю версию все ваши скрипты сразу.

Вынести код в библиотеку

Выделите в редакторе скрипта одну или несколько функций и выберите «Вынести в библиотеку». Функции переедут в новую или существующую библиотеку, а их вызовы в скрипте заменятся на вызовы через Library.use. Функции, которые запускает сам скрипт (например main или onEdit), вынести нельзя.

Проверить функцию библиотеки

На вкладке «Проверка» редактора библиотеки любую функцию можно запустить с аргументами, не создавая скрипт. Аргументы пишутся как в коде: [1, 2, 3], "текст". Такая проверка не обращается к таблицам и секретам и длится не больше 10 секунд.

Кто может

• Видеть, создавать и подключать библиотеки могут участники, которые редактируют таблицы этого рабочего пространства.
• Менять и удалять библиотеку может её автор или владелец рабочего пространства. Остальные видят её в режиме просмотра.
• Удалить библиотеку, которую подключают скрипты, нельзя: сначала уберите её из скриптов.

Ограничения

• до 50 библиотек в рабочем пространстве;
• до 10 библиотек в одном скрипте;
• библиотеки работают только в своём рабочем пространстве.

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