Google Apps Script не отправляет электронные письма: что делать?

07.06.2025
18635

5 мин
412

Краткое описание Google Apps Script и его возможностей отправки электронной почты

Google Apps Script (GAS) — это мощная платформа для автоматизации задач в экосистеме Google Workspace. Одной из ключевых функций является возможность программной отправки электронных писем, что позволяет создавать кастомные уведомления, рассылки отчетов, автоматизировать ответы и многое другое. Сервисы MailApp и GmailApp предоставляют гибкие инструменты для интеграции почтовых функций в ваши скрипты.

Саммари статьи

ChatGPT

Google AI

Grok

Perplexity

Обзор распространенных проблем, при которых Google Apps Script не отправляет электронные письма

Несмотря на удобство, разработчики часто сталкиваются с ситуациями, когда скрипты, предназначенные для отправки почты, не срабатывают или делают это некорректно. Проблемы могут варьироваться от тихих отказов (скрипт выполняется без ошибок, но письма не приходят) до явных ошибок выполнения. Основные причины часто кроются в ограничениях платформы, ошибках конфигурации или проблемах с самим кодом.

Основные причины, по которым Google Apps Script может не отправлять электронные письма

Неправильные настройки авторизации и разрешений (OAuth scope)

Для отправки писем скрипту требуются соответствующие разрешения. При первом запуске или после добавления функциональности отправки почты, GAS запрашивает авторизацию у пользователя. Важно убедиться, что предоставлены необходимые OAuth scopes:

https://www.googleapis.com/auth/script.send_mail (для MailApp)
https://www.googleapis.com/auth/gmail.send (для GmailApp)
https://www.googleapis.com/auth/gmail.compose (для GmailApp, если работаете с черновиками)
https://www.googleapis.com/auth/gmail.modify (для GmailApp, если модифицируете письма)

Эти разрешения должны быть явно указаны в манифесте проекта (appsscript.json) или предоставлены через диалоговое окно авторизации. Недостаточные или отозванные разрешения — частая причина молчаливого отказа.

Превышение дневных лимитов отправки электронной почты Google Workspace

Google накладывает квоты на количество писем, которые можно отправить с помощью Apps Script. Лимиты различаются для бесплатных аккаунтов Gmail (@gmail.com) и платных аккаунтов Google Workspace. Превышение дневной квоты приводит к блокировке отправки до следующего дня. Проверить оставшуюся квоту можно программно:

/**
 * Логирует оставшуюся дневную квоту на отправку писем.
 */
function checkEmailQuota(): void {
  // Используйте MailApp или GmailApp в зависимости от того, какой сервис используется в вашем скрипте
  const remainingQuotaMailApp: Integer = MailApp.getRemainingDailyQuota();
  Logger.log(`Оставшаяся квота MailApp: ${remainingQuotaMailApp}`);

  try {
    const remainingQuotaGmailApp: Integer = GmailApp.getRemainingDailyQuota();
    Logger.log(`Оставшаяся квота GmailApp: ${remainingQuotaGmailApp}`);
  } catch (e) {
    Logger.log(`Не удалось получить квоту GmailApp (возможно, не хватает разрешений): ${e}`);
  }
}

Ошибки в коде Apps Script (синтаксические, логические, runtime)

Ошибки в коде — еще одна распространенная причина проблем:

Синтаксические ошибки: Обычно обнаруживаются редактором GAS.
Логические ошибки: Скрипт выполняется, но делает не то, что ожидалось (например, неверно формируется список получателей, тело письма пустое).
Runtime ошибки: Возникают во время выполнения (например, передача невалидного email-адреса в sendEmail, недоступность внешнего сервиса, используемого для генерации контента).

Тщательная отладка и обработка исключений критически важны.

Проблемы с учетной записью Google (блокировка, ограничения)

Иногда проблема может быть связана не со скриптом, а с самой учетной записью Google, от имени которой он выполняется. Временная блокировка аккаунта за подозрительную активность или специфические ограничения, наложенные администратором Google Workspace, могут препятствовать отправке писем через GAS.

Диагностика и устранение неполадок с отправкой почты

Проверка авторизации и разрешений скрипта

Перейдите в редактор скриптов, откройте Файл > Настройки проекта > Области действия OAuth. Убедитесь, что все необходимые области действия (scopes) присутствуют. Также проверьте разрешения, предоставленные скрипту, в настройках безопасности вашего аккаунта Google (Приложения, имеющие доступ к вашему аккаунту). При необходимости отзовите доступ и авторизуйте скрипт заново.

Анализ логов выполнения скрипта (Execution logs) для выявления ошибок

Логи — ваш главный инструмент диагностики. Используйте Logger.log() или console.log() для вывода значений переменных, этапов выполнения и потенциальных ошибок. Просматривайте логи выполнения в редакторе GAS (Вид > Выполнения). Ищите сообщения об ошибках или неожиданное поведение.

/**
 * Пример отправки письма с логированием ключевых данных.
 * @param {string} recipient Адрес получателя.
 * @param {string} subject Тема письма.
 * @param {string} body Тело письма.
 */
function sendEmailWithLogging(recipient: string, subject: string, body: string): void {
  Logger.log(`Попытка отправки письма:`);
  Logger.log(` - Получатель: ${recipient}`);
  Logger.log(` - Тема: ${subject}`);
  // Не логируйте чувствительные данные в теле письма в продакшене
  // Logger.log(` - Тело: ${body}`);

  if (!recipient || !subject || !body) {
    Logger.log('Ошибка: Отсутствуют необходимые параметры для отправки.');
    return; // Прерываем выполнение, если данные неполные
  }

  try {
    MailApp.sendEmail(recipient, subject, body);
    Logger.log('Письмо успешно отправлено (через MailApp).');
  } catch (error) {
    Logger.log(`Ошибка при отправке письма: ${error.message}`);
    Logger.log(`Stack trace: ${error.stack}`);
  }
}

Использование try…catch блоков для обработки исключений

Оборачивайте вызовы MailApp.sendEmail() или GmailApp.sendEmail() в блоки try...catch, чтобы перехватывать и обрабатывать возможные ошибки во время выполнения. Это позволяет скрипту не падать полностью и логировать или сообщать о проблеме.

/**
 * Отправляет письмо с использованием GmailApp и обработкой ошибок.
 * @param {string} recipient Адрес получателя.
 * @param {string} subject Тема письма.
 * @param {string} body Тело письма (HTML).
 * @param {string} senderName Имя отправителя (опционально).
 */
function sendGmailWithGracefulErrorHandling(recipient: string, subject: string, body: string, senderName?: string): void {
  try {
    const options: GoogleAppsScript.Gmail.GmailAdvancedParameters = {
      htmlBody: body,
    };
    if (senderName) {
      options.name = senderName;
    }

    // Проверка квоты перед отправкой
    const quota: Integer = GmailApp.getRemainingDailyQuota();
    if (quota < 1) {
      throw new Error('Дневная квота GmailApp исчерпана.');
    }

    Logger.log(`Отправка через GmailApp на ${recipient}. Осталось квот: ${quota}`);
    GmailApp.sendEmail(recipient, subject, '', options); // Пустая строка для plain body, т.к. используем htmlBody
    Logger.log('Письмо успешно отправлено через GmailApp.');

  } catch (e) {
    // Логируем ошибку для последующего анализа
    console.error(`Не удалось отправить письмо на ${recipient}: ${e.message}`);
    // Здесь можно добавить логику уведомления администратора
    // sendAdminNotification(`Ошибка отправки письма ${subject} на ${recipient}: ${e.message}`);
  }
}

Тестирование скрипта с упрощенными настройками и небольшим количеством получателей

Перед запуском скрипта на больших объемах данных или со сложной логикой, протестируйте его в упрощенном варианте:

Используйте свой собственный email как единственного получателя.
Задайте простую, статичную тему и тело письма.
Запускайте скрипт вручную из редактора.

Это поможет изолировать проблему: связана ли она с логикой формирования данных или непосредственно с функцией отправки.

Расширенные методы решения проблем

Использование сервиса MailApp.sendEmail() vs. GmailApp.sendEmail(): в чем разница и когда использовать?

MailApp.sendEmail():
- Проще в использовании.
- Отправляет письма от имени пользователя, запустившего скрипт.
- Имеет более строгие дневные квоты (особенно для @gmail.com аккаунтов).
- Не предоставляет доступа к функциям Gmail (черновики, метки).
- Требует scope script.send_mail.
- Подходит для: Простых уведомлений, скриптов, запускаемых одним пользователем.
GmailApp.sendEmail():
- Более гибкий, позволяет использовать HTML, вложения, псевдонимы отправителя (name в опциях).
- Отправляет письма от имени эффективного пользователя (того, кто авторизовал скрипт).
- Использует квоты сервиса Gmail, которые обычно выше (особенно для Google Workspace).
- Интегрируется с Gmail (создание черновиков, применение меток).
- Требует scope gmail.send (или другие gmail.*).
- Подходит для: Рассылок, сложных уведомлений, интеграции с почтовым ящиком, скриптов, работающих от имени сервисного аккаунта или определенного пользователя.

Выбор зависит от требований к функциональности и ожидаемых объемов отправки.

Настройка и использование сервиса управления квотами (Advanced Google Services — Quota Management)

Не существует прямого Advanced Service для управления email квотами GAS. Однако, важно активно мониторить оставшиеся квоты с помощью MailApp.getRemainingDailyQuota() или GmailApp.getRemainingDailyQuota() внутри скрипта, особенно перед выполнением массовых рассылок. Можно реализовать логику, которая приостанавливает отправку или переносит ее на следующий день при достижении порога квоты.

Обход ограничений: отправка писем через сторонние сервисы (например, SendGrid, Mailjet) с использованием API

Если встроенных квот Google недостаточно или требуются расширенные функции (детальная аналитика доставки, выделенные IP-адреса), можно интегрировать GAS со сторонними почтовыми сервисами (Transactional Email Services) через их API.

/**
 * Пример концептуальной отправки через сторонний API (например, SendGrid).
 * Требует получения API ключа и настройки сервиса.
 * @param {string} apiKey Ключ API стороннего сервиса.
 * @param {string} recipient Адрес получателя.
 * @param {string} sender Адрес отправителя (зарегистрированный в сервисе).
 * @param {string} subject Тема письма.
 * @param {string} body Тело письма (HTML).
 */
function sendEmailViaThirdPartyAPI(apiKey: string, recipient: string, sender: string, subject: string, body: string): void {
  const apiUrl: string = 'https://api.sendgrid.com/v3/mail/send'; // Пример URL API

  const payload = {
    personalizations: [{ to: [{ email: recipient }] }],
    from: { email: sender },
    subject: subject,
    content: [{ type: 'text/html', value: body }],
  };

  const options: GoogleAppsScript.URL_Fetch.URLFetchRequestOptions = {
    method: 'post',
    contentType: 'application/json',
    headers: {
      Authorization: `Bearer ${apiKey}`,
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true, // Важно для обработки ошибок API
  };

  try {
    const response: GoogleAppsScript.URL_Fetch.HTTPResponse = UrlFetchApp.fetch(apiUrl, options);
    const responseCode: Integer = response.getResponseCode();
    const responseBody: string = response.getContentText();

    if (responseCode >= 200 && responseCode < 300) {
      Logger.log(`Письмо успешно отправлено через API на ${recipient}. Статус: ${responseCode}`);
    } else {
      Logger.log(`Ошибка API при отправке на ${recipient}. Статус: ${responseCode}, Ответ: ${responseBody}`);
      // Дополнительная обработка ошибки API
    }
  } catch (error) {
    Logger.log(`Критическая ошибка при вызове API: ${error.message}`);
  }
}

Альтернативные стратегии отправки больших объемов писем (например, пакетная обработка)

Для обхода мгновенных лимитов отправки (rate limits) и для более плавной работы в рамках дневных квот:

Пакетная отправка: Обрабатывайте получателей группами (например, по 50-100 человек за запуск скрипта).
Задержки: Используйте Utilities.sleep(milliseconds) между отправками писем в цикле (например, Utilities.sleep(1000) для паузы в 1 секунду). Это снижает риск превышения краткосрочных лимитов.
Триггеры: Используйте временные триггеры (time-driven triggers) для запуска скрипта несколько раз в день, распределяя нагрузку.

Google Apps Script не отправляет электронные письма: что делать?

Краткое описание Google Apps Script и его возможностей отправки электронной почты

Обзор распространенных проблем, при которых Google Apps Script не отправляет электронные письма

Основные причины, по которым Google Apps Script может не отправлять электронные письма

Неправильные настройки авторизации и разрешений (OAuth scope)

Превышение дневных лимитов отправки электронной почты Google Workspace

Ошибки в коде Apps Script (синтаксические, логические, runtime)

Проблемы с учетной записью Google (блокировка, ограничения)

Диагностика и устранение неполадок с отправкой почты

Проверка авторизации и разрешений скрипта

Анализ логов выполнения скрипта (Execution logs) для выявления ошибок

Использование try…catch блоков для обработки исключений

Тестирование скрипта с упрощенными настройками и небольшим количеством получателей

Расширенные методы решения проблем

Использование сервиса MailApp.sendEmail() vs. GmailApp.sendEmail(): в чем разница и когда использовать?

Настройка и использование сервиса управления квотами (Advanced Google Services — Quota Management)

Обход ограничений: отправка писем через сторонние сервисы (например, SendGrid, Mailjet) с использованием API

Альтернативные стратегии отправки больших объемов писем (например, пакетная обработка)

Рекомендации по предотвращению проблем с отправкой писем в будущем

Проектирование скриптов с учетом ограничений Google Workspace

Внедрение системы мониторинга и оповещений об ошибках

Регулярное обновление и тестирование скриптов

Метки:

Добавить комментарий

Google Apps Script не отправляет электронные письма: что делать?

Краткое описание Google Apps Script и его возможностей отправки электронной почты

Обзор распространенных проблем, при которых Google Apps Script не отправляет электронные письма

Основные причины, по которым Google Apps Script может не отправлять электронные письма

Неправильные настройки авторизации и разрешений (OAuth scope)

Превышение дневных лимитов отправки электронной почты Google Workspace

Ошибки в коде Apps Script (синтаксические, логические, runtime)

Проблемы с учетной записью Google (блокировка, ограничения)

Диагностика и устранение неполадок с отправкой почты

Проверка авторизации и разрешений скрипта

Анализ логов выполнения скрипта (Execution logs) для выявления ошибок

Использование try…catch блоков для обработки исключений

Тестирование скрипта с упрощенными настройками и небольшим количеством получателей

Расширенные методы решения проблем

Использование сервиса MailApp.sendEmail() vs. GmailApp.sendEmail(): в чем разница и когда использовать?

Настройка и использование сервиса управления квотами (Advanced Google Services — Quota Management)

Обход ограничений: отправка писем через сторонние сервисы (например, SendGrid, Mailjet) с использованием API

Альтернативные стратегии отправки больших объемов писем (например, пакетная обработка)

Рекомендации по предотвращению проблем с отправкой писем в будущем

Проектирование скриптов с учетом ограничений Google Workspace

Внедрение системы мониторинга и оповещений об ошибках

Регулярное обновление и тестирование скриптов

Метки:

Добавить комментарий

Какие реальные примеры приложений на NativeScript раскрывают весь потенциал этой платформы?

Всеобъемлющий обзор удаленной работы разработчиком Google Apps Script: вакансии, требования, зарплаты и перспективы

Как эффективно использовать прослушиватель событий в Apps Script: Руководство по триггерам?