Для одного действия в браузерной версии Sheets можно вставить рисунок или изображение и назначить ему имя функции Apps Script без скобок. Но такая кнопка не запускается при нажатии на мобильном устройстве. Если важна предсказуемость для команды, добавьте пользовательское меню через `onOpen`; для формы с несколькими полями используйте sidebar.

Скрипт должен быть привязан к конкретной таблице. Откройте Extensions → Apps Script, создайте функцию верхнего уровня, сохраните проект и один раз выполните её от имени владельца для проверки разрешений. Не передавайте в кнопку имя функции из ячейки и не используйте `eval`.

Выберите интерфейс по сценарию

ВариантКогда подходитОграничение
Рисунок или imageОдна заметная desktop-командаКлик не запускает script на mobile
Custom menuНесколько действий для редакторов файлаПоявляется после открытия и выполнения onOpen
SidebarФорма, выбор параметров, прогрессНужен HTML и асинхронный client/server обмен
MacroЗапись повторяемых операций с ячейкамиСложнее контролировать бизнес-валидацию
Checkbox + triggerWorkflow прямо в строкахТребует аккуратной обработки 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 идемпотентным.

Рисунку назначают имя без скобок

  1. Вставьте Drawing или image поверх ячеек.
  2. Откройте меню объекта и выберите Assign script.
  3. Введите `confirmSelectedOrder`, а не `confirmSelectedOrder()`.
  4. Нажмите объект в браузере и пройдите запрос авторизации.
  5. Проверьте действие под обычным редактором, а не только владельцем.

Назначение работает только для функции, доступной в 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 передавать не нужно.

Проверенные источники