Time-driven trigger Apps Script не является cron с гарантией точной минуты. Google прямо указывает, что время может быть слегка рандомизировано: например, триггер «в 9 утра» выбирает момент между 9:00 и 10:00 и затем сохраняет этот сдвиг. Если нужен запуск ровно в 09:00, сама модель инструмента не соответствует требованию.
Сначала откройте Apps Script → Executions и найдите запуск типа Time-driven. Если start time лежит в штатном окне, это не сбой. Статус `DELAYED` означает ожидание квоты; `FAILED` и `TIMED_OUT` указывают уже на выполнение функции. Полное отсутствие записи требует проверки существования trigger и аккаунта-создателя.
Четыре похожих симптома имеют разные причины
| Наблюдение | Что это означает | Действие |
|---|---|---|
| Запуск каждый день в 09:37 | Выбран устойчивый сдвиг внутри часа | Не ожидать 09:00 или сменить внешний scheduler |
| Process status DELAYED | Выполнение ждёт доступной квоты | Снизить частоту/параллельность и проверить usage |
| FAILED сразу после старта | Исключение, доступ или OAuth scope | Открыть execution log и исправить первую ошибку |
| TIMED_OUT после долгой работы | Функция не уложилась в лимит | Разбить работу на небольшие идемпотентные пачки |
| Execution отсутствует | Триггер удалён, создан другим аккаунтом или не активировался | Проверить My Triggers и владельца |
Installable trigger всегда работает от имени аккаунта, который его создал. Коллега может видеть проект, но не видеть чужой trigger в своём списке. После увольнения или изменения прав автоматизация часто ломается именно на этой границе.
Логируйте плановый интервал, а не только текущее время
function runHourly() {
const lock = LockService.getScriptLock();
if (!lock.tryLock(5000)) return;
try {
const props = PropertiesService.getScriptProperties();
const last = Number(props.getProperty('last_completed_slot') || 0);
const current = Math.floor(Date.now() / 3600000);
for (let slot = last + 1; slot <= current; slot++) {
processSlotIdempotently(slot);
props.setProperty('last_completed_slot', String(slot));
}
} finally {
lock.releaseLock();
}
}Это условный каркас. `processSlotIdempotently` должен повторно запускаться без дублей, а число догоняемых интервалов нужно ограничить, чтобы один поздний запуск не исчерпал runtime. Script Properties подходят для небольшого состояния, но не заменяют журнал задач при большом потоке.
Квоты видны по статусам и сообщениям
Apps Script публикует отдельную дневную квоту суммарного runtime triggers и ограничения параллельных запусков. Значения различаются для consumer и Workspace accounts и могут меняться, поэтому берите их с текущей страницы Quotas, а не из старого сообщения форума. Ошибка «Service using too much computer time for one day» прямо указывает на исчерпание runtime.
- Уберите trigger, который создаётся заново при каждом ручном запуске setup.
- Объединяйте мелкие операции чтения и записи Sheets в пакетные вызовы.
- Храните checkpoint после завершённой пачки, а не перед началом.
- Ограничьте одновременный запуск через LockService.
- Настройте уведомление по возрасту последнего успешного slot, а не по минуте старта.
Когда Apps Script нужно оставить, а когда заменить
Если задача допускает окно в десятки минут и умеет догонять интервалы, time-driven trigger подходит. Для платежного закрытия, внешнего SLA или точного расписания используйте scheduler с гарантированным временем и наблюдаемой очередью, а Apps Script вызывайте как зависимость только если это безопасно и поддерживаемо.
Не лечите задержку созданием триггера каждую минуту: это увеличивает конкуренцию и расход квоты. Сначала измерьте фактическое распределение startTime и duration за несколько дней, затем выберите частоту на основе объёма работы.
Проверка после изменения занимает полный цикл
Удалите только дублирующие triggers, оставьте один ожидаемый schedule и наблюдайте несколько плановых окон. Для каждого сохраните slot, startTime, duration, processStatus и число обработанных элементов. Успех — данные обработаны один раз, задержка укладывается в согласованное окно, а пропущенный slot догоняется без дублей.
В отчёт передайте настройки trigger, timezone проекта, владельца, список статусов Executions и обезличенные quota errors. OAuth token, содержимое таблиц и данные пользователей не нужны.