Посчитайте реальные обращения к API одного запуска: чтения, записи, поиск метаданных и повторы после отказов. Небольшая таблица способна породить много запросов, если каждая ячейка читается отдельно. Сначала установите, какой сервис и какая квота вернули ошибку: лимит Sheets API и максимальное время Apps Script — разные ограничения.

Бюджет запроса начинается за пределами основного цикла

УчастокЧто включить в счёт
ПодготовкаПроверка структуры и метаданных
ЧтениеКаждый фактический запрос диапазона
ЗаписьВсе операции обновления и добавления
ПовторКаждая новая попытка после ошибки
Параллельные задачиДругие потребители того же бюджета

Google Sheets API применяет поминутные квоты, включая ограничения проекта и пользователя; при превышении возможен HTTP 429. Руководство рекомендует exponential backoff. Источник проверен 24 октября 2026 года. Численные значения сверяйте по действующей документации и настройкам проекта, а не переносите из статьи для другого API.

Поставьте счётчик на границе API-клиента, чтобы учитывать и вспомогательные вызовы. Сравните число запросов с числом полезно обработанных объектов. Отдельно запишите инициатора и ключ квоты без токена. По одному общему числу строк нельзя понять, расходует ли бюджет ваш цикл или несколько параллельных задач.

Укрупняйте диапазоны, сохраняя смысл операции

Условная смета, не значения квоты Google:
построчно: чтение + запись для каждого элемента
пакетно: чтение согласованного диапазона
локально: преобразование и проверка
запись: только необходимые изменения
повторы: отдельный ограниченный бюджет

Объединяйте совместимые чтения и записи средствами выбранного API. Не превращайте оптимизацию в бесконтрольную перезапись всего листа: пользователь мог изменить данные между чтением и записью. Согласуйте область владения, проверку версии или другой предусмотренный способ избежать потери чужих изменений.

Большой пакет тоже имеет цену: объём, время обработки и сложность диагностики. Выбирайте размер на тестовом наборе и фиксируйте контрольные точки. Если задача должна продолжиться после отказа, checkpoint относится к подтверждённым результатам, а не просто к последней начатой строке.

429 не лечится немедленным повтором всех задач

Backoff увеличивает паузы между повторами; случайная составляющая помогает не запускать все клиенты одновременно. Ограничьте число попыток и общее время ожидания, затем отдайте задачу на управляемое продолжение. Ошибку полномочий или неверный запрос не нужно повторять по схеме временного ограничения квоты.

  1. Измерить вызовы одного тестового запуска без параллельных задач.
  2. Повторить с предусмотренной конкуренцией.
  3. Имитировать отказ квоты и проверить ограничение повторов.
  4. Потерять ответ записи и сверить фактический исход.
  5. Продолжить с контрольной точки без повторного добавления строк.

Повтор append после потерянного ответа способен добавить дубль, даже если алгоритм ожидания идеален. Задайте идентичность записываемых данных и способ сверки результата. Для внешних эффектов вроде отправки письма нужна отдельная защита: успех записи в таблицу не доказывает успех отправки и наоборот.

Для доработки нужны название API, тип квоты, схема вызовов и количество повторов на тестовом запуске. Результат — известна стоимость полезной обработки, пачки не затирают чужие данные, а временный отказ не превращает весь парк задач в шторм запросов.

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