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

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