Когда таблица «перестала обновляться», причина может быть в коде, данных, доступе или самом расписании. Google Apps Script уже хранит журнал выполнений — используйте его как точку входа. Нужна последняя конкретная execution, а не воспоминание о том, когда всё работало.
Запишите функцию, deployment или trigger, время, длительность, статус, пользователя и первую строку stack trace. Не публикуйте значения ячеек и токены из логов. Этого набора обычно достаточно, чтобы выбрать правильную ветку диагностики.
Manual и trigger разделяют причины пополам
| Наблюдение | Вероятная область | Следующее действие |
|---|---|---|
| Ручной запуск тоже падает | Код, данные, доступ или квота | Разобрать stack trace |
| Ручной работает, time trigger падает | Владелец/авторизация/контекст | Проверить installable trigger |
| Выполнений по расписанию нет | Триггер удалён или не создан | Открыть Triggers |
| Падает только один файл | Доступ или структура данных | Сверить spreadsheet id и лист |
| Ошибки приходят волнами | Квота или временный сервис | Смотреть частоту и повтор |
Installable trigger выполняется от имени создавшего его пользователя, даже если таблицу сейчас редактирует коллега. Если сотрудник ушёл, потерял доступ или скрипту понадобился новый scope, расписание может сломаться при рабочем ручном запуске другого пользователя.
Лог ставят вокруг границы, а не у каждой строки
function refreshReport() {
const runId = Utilities.getUuid();
console.log({runId, step: 'start'});
try {
const sheet = SpreadsheetApp.getActive().getSheetByName('Report');
if (!sheet) throw new Error('Sheet Report not found');
console.log({runId, step: 'sheet_ready', lastRow: sheet.getLastRow()});
// Обновление отчёта
} catch (error) {
console.error({runId, step: 'failed', message: error.message});
throw error;
}
}Это пример контрольных точек. Не логируйте строки таблицы целиком, email, access token или содержимое документов. Повторный `throw` сохраняет failed status выполнения; если проглотить исключение после `console.error`, мониторинг может ошибочно считать запуск успешным.
Stack trace проверяют вместе с данными листа
- Переименован или удалён лист, на который ссылается `getSheetByName`.
- Колонки сдвинулись, а код использует жёсткие номера диапазонов.
- Пустая выборка привела к диапазону нулевого размера.
- Формат даты или числа изменился из-за locale таблицы.
- Spreadsheet ID заменён копией, к которой нет доступа.
- Внешний API вернул HTML/ошибку вместо ожидаемого JSON.
- Одновременные запуски редактируют один диапазон.
Перейдите по первой строке своего кода в stack trace и проверьте значения непосредственно перед ней на копии данных. Ошибка в библиотеке часто вызвана неверным аргументом, сформированным несколькими строками выше.
Новые сервисы могут потребовать повторной авторизации
Apps Script определяет scopes из используемых сервисов. Если в проект добавили Gmail, Drive или внешний запрос, ручной запуск может показать диалог новых разрешений. Триггер не может провести пользователя через такой диалог во время фонового выполнения. Авторизацию выполняют осознанно под владельцем, после проверки требуемых scopes и политики организации.
| Сигнал | Проверка | Не делать |
|---|---|---|
| Authorization required | Ручной запуск владельцем | Не раздавать всем editor |
| Access denied | Доступ к файлу/папке | Не менять владельца наугад |
| Service invoked too many times | Таблица quotas и частота | Не крутить tight retry |
| Service unavailable | Повтор с задержкой и статус | Не терять исходную ошибку |
| Exceeded execution time | Объём и пакетная обработка | Не запускать дубли |
Квоты и временные сбои оставляют разный рисунок
Google публикует квоты, которые зависят от типа аккаунта и могут меняться. Поэтому не зашивайте найденное в старой статье число как вечную норму. Смотрите точный текст exception, длительность и число запусков. Для временного внешнего сбоя допустим ограниченный retry с задержкой; исчерпанная дневная квота от быстрых повторов не восстановится.
Восстановление заканчивается контрольным запуском
- Сохранить данные failed execution и stack trace.
- Воспроизвести функцию вручную на тестовой копии.
- Исправить одну доказанную причину и добавить контрольную точку.
- Проверить владельца, scopes и installable trigger.
- Запустить малый набор данных и сверить результат.
- Дождаться следующего планового выполнения и проверить его карточку.
Работа завершена, когда следующий фоновый запуск имеет success status, обновил ожидаемый диапазон ровно один раз и оставил короткий технический лог. Зафиксируйте владельца триггера и процедуру передачи доступа — это предотвращает повтор проблемы при смене команды.