Для одного действия в браузерной версии Sheets можно вставить рисунок или изображение и назначить ему имя функции Apps Script без скобок. Но такая кнопка не запускается при нажатии на мобильном устройстве. Если важна предсказуемость для команды, добавьте пользовательское меню через `onOpen`; для формы с несколькими полями используйте sidebar.
Скрипт должен быть привязан к конкретной таблице. Откройте Extensions → Apps Script, создайте функцию верхнего уровня, сохраните проект и один раз выполните её от имени владельца для проверки разрешений. Не передавайте в кнопку имя функции из ячейки и не используйте `eval`.
Выберите интерфейс по сценарию
| Вариант | Когда подходит | Ограничение |
|---|---|---|
| Рисунок или image | Одна заметная desktop-команда | Клик не запускает script на mobile |
| Custom menu | Несколько действий для редакторов файла | Появляется после открытия и выполнения onOpen |
| Sidebar | Форма, выбор параметров, прогресс | Нужен HTML и асинхронный client/server обмен |
| Macro | Запись повторяемых операций с ячейками | Сложнее контролировать бизнес-валидацию |
| Checkbox + trigger | Workflow прямо в строках | Требует аккуратной обработки onEdit и повторов |
Кнопка не должна зависеть от текущего визуального положения строки, если таблицу сортируют. Храните постоянный ID в отдельном столбце и проверяйте его перед изменением внешней системы.
Меню вызывает обычную функцию
function onOpen() {
SpreadsheetApp.getUi()
.createMenu('Заказы')
.addItem('Подтвердить выбранную строку', 'confirmSelectedOrder')
.addToUi();
}
function confirmSelectedOrder() {
const sheet = SpreadsheetApp.getActiveSheet();
const row = sheet.getActiveRange().getRow();
if (row < 2) throw new Error('Выберите строку заказа');
const lock = LockService.getDocumentLock();
lock.waitLock(10000);
try {
const statusCell = sheet.getRange(row, 5);
if (statusCell.getValue() === 'Подтверждён') return;
statusCell.setValue('Подтверждён');
SpreadsheetApp.getActive().toast('Строка обновлена');
} finally {
lock.releaseLock();
}
}Пример меняет только столбец статуса и повторно проверяет его под document lock. Если функция вызывает CRM или отправляет письмо, одного значения в ячейке мало: сначала создайте стабильный operation ID, записывайте результат внешнего вызова и делайте retry идемпотентным.
Рисунку назначают имя без скобок
- Вставьте Drawing или image поверх ячеек.
- Откройте меню объекта и выберите Assign script.
- Введите `confirmSelectedOrder`, а не `confirmSelectedOrder()`.
- Нажмите объект в браузере и пройдите запрос авторизации.
- Проверьте действие под обычным редактором, а не только владельцем.
Назначение работает только для функции, доступной в bound project. Пользователь без права редактирования таблицы не становится администратором из-за кнопки: Apps Script выполняется в контексте и с авторизацией, зависящими от типа запуска.
Ошибку нужно показать рядом с действием
Для короткого результата используйте toast; для подтверждения опасной операции — `Ui.alert` с явными вариантами. Dialog приостанавливает server-side script на время ответа, поэтому не держите до него JDBC connection и lock. Sidebar работает асинхронно и лучше подходит для длинных операций.
- Проверяйте active sheet и диапазон, а не только номер строки.
- Не записывайте данные в защищённые столбцы без понятного сообщения.
- Отключайте повторный эффект на уровне operation ID или состояния.
- Пакетно меняйте несколько ячеек через setValues.
- Не выводите токены и содержимое чужих строк в alert или log.
Приёмка проходит под тремя ролями
Проверьте владельца, обычного редактора и пользователя только с просмотром. Затем нажмите кнопку дважды, поменяйте сортировку и откройте файл на мобильном. Ожидаемый результат: действие выполняется один раз на правильном ID, редактор видит понятный итог, а мобильному пользователю доступен предусмотренный альтернативный путь.
Для доработки подготовьте копию таблицы без персональных данных, названия входных столбцов, ожидаемое изменение и список ролей. Рабочую таблицу с клиентскими данными и OAuth tokens передавать не нужно.