Сервисы Apps Script имеют ежедневные квоты и ограничения на некоторые функции. Если вы превысите квоту или ограничение, ваш скрипт выдаст исключение, и выполнение остановится.
Важно : Для некоторых функций действуют дополнительные квоты, установленные продуктом Google, с которым они связаны. Использование сервиса Apps Script в рамках продукта учитывается во всех связанных с ним резервах квот. Функция становится недоступной, если вы превысите какой-либо из связанных с ней лимитов.
Текущие квоты
Для пользователей потребительских (например, gmail.com) или бесплатных (прекративших поддержку) учетных записей G Suite и Google Workspace установлены разные уровни квот. Квоты начисляются каждому пользователю и сбрасываются через 24 часа после первого запроса.
Используйте указанные ниже квоты для тестирования ваших скриптов. Все квоты могут быть отменены, уменьшены или изменены в любое время без предварительного уведомления.
| Особенность | Потребитель (например, gmail.com) и Бесплатная версия G Suite ( наследие ) | Google Workspace счета |
|---|---|---|
| Созданы события календаря | 5000 в день | 10 000 в день |
| Созданные контакты | 1000 в день | 2000 в день |
| Созданные документы | 250 / день | 1500 / день |
| Файлы преобразованы | 2000 в день | 4000 в день |
| Количество получателей электронных писем в день (например, с помощью MailApp) | 100 * / день | 1500 * / день |
| Количество получателей электронных писем в день в пределах домена (например, с помощью MailApp) | 100 * / день | 2000 в день |
| Чтение/запись электронных писем (за исключением отправки) | 20 000 в день | 50 000 в день |
| Группы читают | 2000 в день | 10 000 в день |
| JDBC-соединение | 10 000 в день | 50 000 в день |
| JDBC не удалось установить соединение. | 100 / день | 500 / день |
| Созданные презентации | 250 / день | 1500 / день |
| Свойства чтения/записи | 50 000 в день | 500 000 в день |
| Слайды созданы | 250 / день | 1500 / день |
| Созданы электронные таблицы | 250 / день | 3200 / день |
| Запускает общее время выполнения | 90 мин/день | 6 часов в день |
| Вызовы URL-запроса | 20 000 в день | 100 000 в день |
| Статическая отрисовка карты | 1000 в день | 10 000 в день |
| Запрос маршрута на карте Google | 1000 в день | 10 000 в день |
| Вызовы геокодирования Google Maps | 1000 в день | 10 000 в день |
| Перевод звонков | 5000 в день | 20 000 в день |
| Запрос образцов высот на карте Google | 1000 в день | 10 000 в день |
| Проекты Apps Script | 50 / день | 50 / день |
Текущие ограничения
Используйте указанные ниже ограничения для тестирования ваших скриптов. Все ограничения могут быть отменены, уменьшены или изменены в любое время без предварительного уведомления.
| Особенность | Потребитель (например, gmail.com) и Бесплатная версия G Suite ( наследие ) | Google Workspace счета |
|---|---|---|
| среда выполнения скрипта | 6 мин / исполнение | 6 мин / исполнение |
| Среда выполнения пользовательских функций | 30 сек / выполнение | 30 сек / выполнение |
| Среда выполнения надстройки Google Workspace | 30 сек / выполнение | 30 сек * / выполнение |
| Одновременное выполнение для каждого пользователя | 30 / пользователь | 30 / пользователь |
| Одновременное выполнение каждого скрипта | 1000 | 1000 |
| Вложения в электронные письма | 250 / сообщение | 250 / сообщение |
| Размер текста письма | 200 КБ / сообщение | 400 КБ / сообщение |
| Количество получателей в каждом сообщении | 50 / мсг | 50 / мсг |
| Общий размер вложений в электронном письме | 25 МБ / сообщение | 25 МБ / сообщение |
| Размер значения свойств | 9 КБ / вал | 9 КБ / вал |
| Свойства общего объема памяти | 500 КБ / хранилище недвижимости | 500 КБ / хранилище недвижимости |
| Триггеры | 20 / пользователь / скрипт | 20 / пользователь / скрипт |
| Размер ответа URL-запроса | 50 МБ/звонок | 50 МБ/звонок |
| Заголовки URL-запроса | 100 / звонок | 100 / звонок |
| Размер заголовка URL-запроса | 8 КБ / звонок | 8 КБ / звонок |
| Размер POST-запроса (получение URL) | 50 МБ/звонок | 50 МБ/звонок |
| Получение URL-адреса Длина URL-адреса | 2 КБ / звонок | 2 КБ / звонок |
| Версии | 200 / скрипт | 200 / скрипт |
Мониторинг использования квоты
Для мониторинга потребления квоты и состояния выполнения вашего скрипта используйте следующие методы:
- Квота на рассылку электронных писем : используйте
MailApp.getRemainingDailyQuota(), чтобы проверить количество оставшихся получателей электронных писем, которым вы можете отправить письма до конца дня. - Мониторинг выполнения : используйте панель управления Apps Script для просмотра истории выполнения и состояния ваших скриптов. На странице «Мои выполнения» отображается статус (например,
Completed,Failed» илиRunning») каждого выполнения скрипта. Вы можете отслеживать количество одновременных выполнений, отфильтровав их по статусуRunning. - Консоль Google Cloud : Если ваш проект Apps Script использует стандартный проект Google Cloud , вы можете отслеживать квоты для конкретных сервисов и использование API в консоли Google Cloud .
Сообщения об исключениях
Если скрипт достигает квоты или лимита, он генерирует исключение с сообщением, похожим на следующее:
-
Limit exceeded: Email Attachments Per Message.Это означает, что скрипт превысил одну из квот или ограничений, перечисленных выше. -
Service invoked too many times: Calendar.Это указывает на то, что скрипт вызывал данный сервис слишком много раз в течение одного дня. -
Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.Это указывает на то, что скрипт слишком часто вызывал указанный сервис за короткий период времени. -
Service using too much computer time for one day.Это означает, что скрипт превысил допустимое общее время выполнения за один день. Чаще всего это происходит со скриптами, запускаемыми по триггеру , у которых дневной лимит ниже, чем у скриптов, выполняемых вручную. -
Script invoked too many times per second for this Google user account.Это означает, что скрипт начал выполняться слишком много раз за короткий промежуток времени. Чаще всего это происходит с пользовательскими функциями, которые вызываются многократно в одной электронной таблице. Чтобы избежать этой ошибки, напишите свои пользовательские функции так, чтобы их нужно было вызывать только один раз для каждого диапазона данных, как описано в руководстве по пользовательским функциям . -
There are too many scripts running simultaneously for this Google user account.Это означает, что у вас выполняется слишком много скриптов одновременно, хотя и не обязательно один и тот же скрипт. Как и в случае с исключением, описанным выше, это чаще всего происходит с пользовательскими функциями, которые вызываются многократно в одной и той же электронной таблице.
Связанные темы
- Ограничения для триггеров, отображаемых в манифесте .
- Ограничения на срабатывание дополнений редактора .