Как Отправить Письмо с Помощью Google Apps Script: Подробное Руководство по Автоматизации Почты?

  •   
  •   77822
  •   10 мин
  •   30

В современном цифровом мире электронная почта остается одним из ключевых инструментов коммуникации. Однако рутинная отправка однотипных сообщений, отчетов или уведомлений может отнимать значительное время и ресурсы. Именно здесь на помощь приходит Google Apps Script — мощная платформа для разработки, основанная на JavaScript, которая позволяет автоматизировать задачи в экосистеме Google Workspace.

Саммари статьи
ChatGPT ChatGPT
Google AI Google AI
Grok Grok
Perplexity Perplexity

Это руководство предназначено для всех, кто стремится оптимизировать свои рабочие процессы, будь то отправка персонализированных уведомлений из Google Таблиц, автоматическая рассылка отчетов по расписанию или интеграция с внешними почтовыми сервисами. Мы рассмотрим, как Google Apps Script превращает сложные задачи в простые, автоматизированные процессы.

В этом подробном руководстве мы шаг за шагом изучим все аспекты отправки электронных писем с помощью Google Apps Script:

  • Начиная с основ доступа к редактору скриптов и отправки вашего первого простого письма.

  • Сравнивая ключевые инструменты MailApp и GmailApp для различных сценариев.

  • Осваивая автоматизацию с помощью триггеров по времени и событиям.

  • Переходя к продвинутым техникам персонализации и динамического контента.

  • Заканчивая вопросами оптимизации, обработки ошибок и использования внешних Email API.

Приготовьтесь раскрыть полный потенциал автоматизации почты и значительно повысить свою продуктивность.

Начало работы с Google Apps Script и ваша первая электронная почта

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

Доступ к редактору скриптов можно получить несколькими способами:

  • Из любого документа Google Workspace (Таблицы, Документы, Презентации, Формы): перейдите в меню Расширения > Apps Script.

  • Напрямую через веб-интерфейс: откройте script.google.com. Это создаст новый проект скрипта.

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

Начнем с самого простого способа отправки письма — используя встроенный сервис MailApp. Этот сервис идеально подходит для отправки базовых текстовых сообщений.

Пошаговое руководство:

  1. Откройте редактор скриптов (как описано выше).

  2. Вставьте следующий код в файл Code.gs, заменив существующий шаблон myFunction().

  3. Сохраните проект (значок дискеты или Ctrl+S/Cmd+S).

  4. Выберите функцию sendSimpleEmail из выпадающего списка над редактором кода.

  5. Нажмите кнопку "Выполнить" (значок воспроизведения).

  6. При первом запуске потребуется авторизовать скрипт, предоставив ему необходимые разрешения для отправки писем от вашего имени. Внимательно ознакомьтесь с запросом и подтвердите.

Пример кода:

function sendSimpleEmail() {
  var recipient = "ваш_email@example.com"; // Замените на адрес получателя
  var subject = "Привет из Google Apps Script!";
  var body = "Это простое текстовое письмо, отправленное с помощью Google Apps Script.";

  MailApp.sendEmail(recipient, subject, body);

  Logger.log("Письмо успешно отправлено на: " + recipient);
}

После успешного выполнения скрипта вы получите письмо на указанный адрес. Это демонстрирует базовую функциональность MailApp для отправки сообщений.

Что такое Google Apps Script и как получить доступ к редактору скриптов

Google Apps Script (GAS) — это мощная облачная платформа разработки на основе JavaScript, которая позволяет автоматизировать, интегрировать и расширять функциональность сервисов Google Workspace. Представьте, что у вас есть персональный помощник, который может выполнять рутинные задачи в Gmail, Google Таблицах, Документах, Календаре, Диске и Формах, а также создавать собственные веб-приложения. GAS не требует установки какого-либо программного обеспечения, поскольку все скрипты выполняются на серверах Google, что делает его доступным и удобным инструментом для автоматизации.

С помощью Google Apps Script вы можете:

  • Автоматизировать отправку электронных писем на основе определенных условий.

  • Создавать пользовательские функции для Google Таблиц.

  • Интегрировать различные сервисы Google Workspace между собой.

  • Разрабатывать простые веб-приложения и API.

Доступ к редактору скриптов Google Apps Script можно получить двумя основными способами:

  1. Из приложения Google Workspace:

    • Откройте любой файл Google Таблиц, Документов, Презентаций или Форм.

    • В верхнем меню выберите Расширения > Apps Script.

    • Это действие откроет новый проект скрипта, который будет "привязан" к текущему файлу. Такой скрипт может легко взаимодействовать с данными этого файла.

  2. Как отдельный (автономный) проект:

    • Перейдите непосредственно по адресу script.google.com.

    • Здесь вы можете создать новый проект, который не будет привязан к конкретному файлу Google Workspace. Автономные скрипты идеально подходят для задач, которые не зависят от одного документа, например, для регулярных рассылок или интеграции с внешними API.

После открытия редактора скриптов вы увидите интуитивно понятный интерфейс: основную область для написания кода JavaScript, панель для управления файлами проекта, а также кнопки для сохранения, запуска и отладки ваших скриптов. Именно здесь мы будем писать код для автоматизации отправки писем.

Отправка простого текстового письма: пошаговое руководство и пример кода

Теперь, когда редактор скриптов открыт и готов к работе, давайте напишем наш первый скрипт для отправки простого текстового письма. Для этого мы будем использовать встроенный сервис MailApp, который является самым простым способом отправки электронных писем в Google Apps Script.

Пошаговое руководство:

  1. Откройте редактор скриптов: Если вы еще не сделали этого, откройте редактор скриптов (как описано в предыдущем разделе).

  2. Создайте новую функцию: В файле Code.gs (или любом другом файле .gs) удалите существующий код function myFunction() {} и вставьте следующий:

    function sendSimpleEmail() {
  var recipient = 'ваш_email@example.com'; // Замените на свой адрес электронной почты
  var subject = 'Привет из Google Apps Script!';
  var body = 'Это ваше первое автоматическое письмо, отправленное с помощью Google Apps Script.';

  MailApp.sendEmail(recipient, subject, body);

  Logger.log('Письмо успешно отправлено на: ' + recipient);
}

  3. Замените ваш_email@example.com на свой реальный адрес электронной почты, чтобы получить тестовое письмо.

  4. Сохраните скрипт: Нажмите на иконку дискеты или Ctrl + S (или Cmd + S).

  5. Запустите функцию: В верхней панели редактора скриптов выберите sendSimpleEmail из выпадающего списка функций и нажмите кнопку «Выполнить» (иконка треугольника).

  6. Авторизуйте скрипт: При первом запуске Google попросит вас авторизовать скрипт для доступа к вашим данным (в данном случае, для отправки писем от вашего имени). Следуйте инструкциям на экране, чтобы предоставить необходимые разрешения. Это стандартная процедура безопасности.

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

Выбор инструмента: Сравнение MailApp и GmailApp для отправки писем

После того как мы освоили базовую отправку писем с помощью MailApp, пришло время углубиться в возможности и выбрать наиболее подходящий инструмент для ваших задач. Google Apps Script предлагает два основных сервиса для работы с электронной почтой: MailApp и GmailApp. Хотя оба позволяют отправлять письма, они имеют ключевые отличия, определяющие их сценарии использования.

Ключевые отличия, преимущества и сценарии использования MailApp и GmailApp

  • MailApp: Это более простой и универсальный сервис, который не требует доступа к аккаунту Gmail пользователя. Он идеально подходит для отправки общих уведомлений или системных сообщений, где не требуется персонализация отправителя или использование специфических функций Gmail. MailApp отправляет письма от имени пользователя, запустившего скрипт, но без возможности выбора алиасов.

  • GmailApp: Этот сервис предоставляет полный доступ к функциям Gmail. Он позволяет отправлять письма от имени любого из ваших настроенных алиасов, работать с черновиками, устанавливать метки и, что важно, отправлять письма с более сложным форматированием, включая встроенные (inline) изображения. GmailApp требует авторизации для доступа к аккаунту Gmail пользователя и является предпочтительным выбором для персонализированных рассылок и интеграции с экосистемой Gmail.

Отправка писем с форматированием (HTML), вложениями и inline-изображениями

Оба сервиса поддерживают отправку писем с HTML-форматированием и вложениями, но GmailApp предлагает более широкие возможности:

  • HTML-форматирование: Для отправки HTML-письма достаточно указать параметр htmlBody в объекте опций. Это позволяет создавать красивые, структурированные сообщения.

  • Вложения: Оба сервиса позволяют прикреплять файлы, используя объекты BlobSource (например, файлы из Google Диска или сгенерированные скриптом).

  • Inline-изображения: Это ключевое преимущество GmailApp. Вы можете встраивать изображения непосредственно в тело HTML-письма, что идеально подходит для брендированных шаблонов или подписей. MailApp не поддерживает inline-изображения, только обычные вложения.

Ключевые отличия, преимущества и сценарии использования MailApp и GmailApp

Хотя оба сервиса, MailApp и GmailApp, позволяют отправлять электронные письма из Google Apps Script, они предназначены для разных сценариев и предоставляют различный уровень контроля. Понимание их ключевых отличий критически важно для выбора правильного инструмента.

MailApp — это упрощенный сервис, предназначенный для отправки базовых электронных писем.

  • Преимущества: Простота использования, минимальные требования к авторизации (достаточно https://www.googleapis.com/auth/script.send_mail). Идеально подходит для быстрых уведомлений и системных сообщений, где отправитель всегда является владельцем скрипта.

  • Ограничения: Письма всегда отправляются от имени основного адреса электронной почты пользователя, запустившего скрипт. Отсутствует возможность указать алиасы, управлять черновиками или использовать расширенные функции Gmail.

GmailApp предоставляет полный доступ к функционалу Gmail, что делает его мощным инструментом для более сложных задач.

  • Преимущества:

    • Отправка от алиасов: Позволяет отправлять письма от любого из настроенных алиасов Gmail (from опция), что критически важно для профессиональной коммуникации.

    • Управление черновиками: Возможность создавать, изменять и отправлять черновики (createDraft, sendDraft), что полезно для предварительного просмотра или отложенной отправки.

    • Расширенные опции: Поддержка replyTo, name, noReply и других параметров, обеспечивающих больший контроль над заголовками письма.

    • Гибкая работа с вложениями: Более продвинутые методы для добавления вложений, включая файлы из Google Диска, и встраивание изображений непосредственно в тело HTML-письма.

  • Ограничения: Требует более широкой области авторизации (https://www.googleapis.com/auth/gmail.send или https://www.googleapis.com/auth/gmail.compose), что может потребовать дополнительного подтверждения при первом запуске.

Сценарии использования:

  • Используйте MailApp для внутренних уведомлений, простых оповещений о событиях в Google Таблицах или Формах, где отправитель не имеет значения, кроме как владелец скрипта.

  • Выбирайте GmailApp для клиентских рассылок, отправки персонализированных отчетов, создания писем с комплексным форматированием и вложениями, а также когда необходимо отправлять письма от имени другого адреса (алиаса) или управлять черновиками.

Отправка писем с форматированием (HTML), вложениями и inline-изображениями

После того как вы определились с выбором между MailApp и GmailApp, перейдем к расширенным возможностям отправки писем, которые значительно повышают их информативность и привлекательность.

Отправка писем с форматированием (HTML)

Для создания визуально привлекательных писем используйте HTML-форматирование через параметр htmlBody. Это позволяет включать заголовки, списки, ссылки и другие элементы.

function sendHtmlEmail() {
  const recipient = 'получатель@example.com';
  const subject = 'Важное сообщение с HTML';
  const htmlContent = `
    <p>Здравствуйте,</p>
    <p>Это <b>тестовое</b> письмо с <i>HTML-форматированием</i>.</p>
  `;

  GmailApp.sendEmail(recipient, subject, '', { htmlBody: htmlContent });
  Logger.log('HTML-письмо отправлено.');
}

Отправка писем с вложениями

Добавление вложений позволяет отправлять документы, изображения или другие файлы. Используйте параметр attachments, который принимает массив объектов BlobSource (например, файлы из Google Диска).

function sendEmailWithAttachment() {
  const recipient = 'получатель@example.com';
  const subject = 'Отчет за март 2026';
  const body = 'Во вложении вы найдете отчет.';
  
  // Предполагаем, что у вас есть файл "Отчет_Март_2026.pdf" на Google Диске
  const file = DriveApp.getFilesByName('Отчет_Март_2026.pdf').next();

  GmailApp.sendEmail(recipient, subject, body, {
    attachments: [file.getAs(MimeType.PDF)]
  });
  Logger.log('Письмо с вложением отправлено.');
}

Отправка писем с inline-изображениями

GmailApp позволяет встраивать изображения непосредственно в тело HTML-письма, что идеально для логотипов или баннеров. Используйте параметр inlineImages и ссылайтесь на изображения по cid (Content ID) в htmlBody.

function sendEmailWithInlineImage() {
  const recipient = 'получатель@example.com';
  const subject = 'Письмо с логотипом';
  
  // Предполагаем, что у вас есть файл "logo.png" на Google Диске
  const logo = DriveApp.getFilesByName('logo.png').next().getAs('image/png');

  const htmlContent = `
    <p>Здравствуйте,</p>
    <img src="cid:logo" alt="Логотип" width="100">
    <p>Это письмо с встроенным логотипом.</p>
  `;

  GmailApp.sendEmail(recipient, subject, '', {
    htmlBody: htmlContent,
    inlineImages: { logo: logo }
  });
  Logger.log('Письмо с встроенным изображением отправлено.');
}

Автоматизация рассылки: Использование триггеров Google Apps Script

После того как мы научились создавать сложные письма с форматированием и вложениями, следующим логичным шагом является их автоматическая отправка. Google Apps Script предоставляет мощный механизм для этого — триггеры. Триггеры позволяют запускать функции скрипта в ответ на определенные события или по заданному расписанию, превращая рутинные задачи в полностью автоматизированные процессы.

Настройка триггеров по времени для регулярных рассылок и уведомлений

Самый простой способ автоматизировать рассылку — это использовать триггеры, основанные на времени. Вы можете настроить скрипт для отправки писем ежедневно, еженедельно или даже ежечасно. Для этого:

  1. Откройте редактор скриптов (Расширения > Apps Script).

  2. В левой панели нажмите на значок «Триггеры» (часы).

  3. Нажмите «Добавить триггер».

  4. Выберите функцию, которую вы хотите запускать (например, sendDailyReport).

  5. Выберите тип события: «По времени».

  6. Укажите интервал (например, «Таймер дня», «Каждый час», «Каждый день»).

Пример функции, которую можно привязать к такому триггеру:

function sendDailyReport() {
  const recipient = 'your_email@example.com';
  const subject = 'Ежедневный отчет';
  const body = 'Привет! Это ваш ежедневный автоматический отчет.';
  MailApp.sendEmail(recipient, subject, body);
}

Автоматическая отправка писем после заполнения Google Формы или изменения данных в Google Таблицах

Триггеры также могут реагировать на события, происходящие в других сервисах Google Workspace:

  • При отправке Google Формы (onFormSubmit): Скрипт может автоматически отправлять подтверждение или уведомление после того, как пользователь заполнит форму. Для этого выберите тип события «Из формы» и «При отправке формы».

  • При изменении данных в Google Таблицах (onEdit/onChange): Вы можете настроить отправку письма, когда определенная ячейка изменяется, или когда добавляется новая строка. Для этого выберите тип события «Из таблицы» и «При изменении» или «При открытии».

    Реклама

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

Настройка триггеров по времени для регулярных рассылок и уведомлений

Продолжая тему автоматизации, одним из наиболее востребованных сценариев является регулярная отправка писем по расписанию. Триггеры Google Apps Script, основанные на времени, позволяют настроить выполнение вашей функции отправки почты через заданные интервалы: ежечасно, ежедневно, еженедельно или ежемесячно. Это идеальное решение для автоматических отчетов, напоминаний или новостных рассылок.

Для настройки такого триггера выполните следующие шаги:

  1. Откройте редактор скриптов: В вашем проекте Google Apps Script перейдите в раздел «Триггеры» (значок часов на левой панели).

  2. Добавьте новый триггер: Нажмите кнопку «Добавить триггер» в правом нижнем углу.

  3. Настройте параметры: В появившемся окне:

    • Выберите функцию для запуска: Укажите имя функции, которая будет отправлять письмо (например, sendDailyReport).

    • Выберите, какой тип развертывания должен запускаться: Оставьте «Head».

    • Выберите тип источника события: Выберите «По времени».

    • Выберите тип триггера, основанный на времени: Выберите нужный интервал, например, «Ежедневный таймер».

    • Выберите время дня: Укажите желаемый временной диапазон для запуска.

  4. Сохраните триггер: Нажмите «Сохранить».

Пример функции, которую можно использовать с ежедневным триггером:

function sendDailyReport() {
  const recipient = 'your_email@example.com';
  const subject = 'Ежедневный отчет от ' + new Date().toLocaleDateString('ru-RU');
  const body = 'Здравствуйте! Это ваш автоматический ежедневный отчет.';
  
  MailApp.sendEmail(recipient, subject, body);
  Logger.log('Ежедневный отчет отправлен.');
}

Теперь ваша функция sendDailyReport будет автоматически выполняться в заданное время каждый день, отправляя письмо указанному получателю.

Автоматическая отправка писем после заполнения Google Формы или изменения данных в Google Таблицах

Помимо триггеров, основанных на времени, Google Apps Script предлагает мощные возможности для автоматизации, реагируя на конкретные события. Это особенно полезно для мгновенной обратной связи или уведомлений после взаимодействия пользователей с вашими Google Формами или Таблицами.

Автоматизация после заполнения Google Формы

Когда пользователь отправляет Google Форму, вы можете автоматически отправить электронное письмо с подтверждением или уведомлением. Для этого используется триггер On form submit.

  1. Создайте функцию, которая будет обрабатывать отправку формы. Эта функция автоматически получит объект события e, содержащий данные формы.

    function sendEmailOnFormSubmit(e) {
  var email = "ваш_email@example.com"; // Куда отправлять уведомление
  var subject = "Новая заявка из формы";
  var message = "Получена новая заявка:\n\n";

  // e.namedValues содержит данные формы в виде объекта
  for (var key in e.namedValues) {
    message += key + ": " + e.namedValues[key] + "\n";
  }

  MailApp.sendEmail(email, subject, message);
}

  2. Настройте триггер: В редакторе скриптов перейдите в раздел «Триггеры» (значок часов). Нажмите «Добавить триггер», выберите функцию sendEmailOnFormSubmit, затем в качестве источника события укажите «Из формы» и тип события «При отправке формы».

Автоматическая отправка писем при изменении данных в Google Таблицах

Вы также можете настроить отправку писем при изменении данных в Google Таблицах, например, при обновлении статуса заказа или добавлении новой строки. Для этого используются триггеры On edit или On change.

  1. Создайте функцию, которая будет реагировать на изменения. Функция также получает объект события e, содержащий информацию об изменении (например, диапазон, новое значение).

    function sendEmailOnSheetEdit(e) {
  var range = e.range; // Диапазон, который был изменен
  var sheet = range.getSheet();

  // Пример: Отправка письма, если изменена ячейка A1 на листе 'Dashboard'
  if (sheet.getName() == 'Dashboard' && range.getA1Notation() == 'A1') {
    var newValue = range.getValue();
    var email = "ваш_email@example.com";
    var subject = "Изменение в ячейке A1";
    var message = "Ячейка A1 на листе 'Dashboard' изменена на: " + newValue;
    MailApp.sendEmail(email, subject, message);
  }
}

  2. Настройте триггер: В разделе «Триггеры» добавьте новый триггер. Выберите функцию sendEmailOnSheetEdit, источник события «Из таблицы» и тип события «При изменении» или «При редактировании» (рекомендуется «При редактировании» для пользовательских изменений).

Продвинутые сценарии: Динамическая отправка писем и персонализация

Продолжая тему автоматизации, мы переходим к созданию по-настоящему динамических и персонализированных рассылок. Это позволяет отправлять письма не просто по событию, а с учетом конкретных данных и условий, делая каждое сообщение максимально релевантным для получателя.

Отправка писем на основе значений ячеек в Google Таблицах: условия и логика

Google Таблицы часто служат централизованным хранилищем данных для рассылок. Вы можете использовать значения ячеек для определения получателей, содержимого письма и даже условий его отправки. Например, отправлять напоминания только тем, чей статус "Просрочено" или чей срок выполнения подходит к концу.

Для этого необходимо:

  1. Получить данные из таблицы: Используйте SpreadsheetApp для доступа к активной таблице и листу.

  2. Итерировать по строкам: Пройдитесь по каждой строке, чтобы извлечь нужную информацию (email, имя, статус и т.д.).

  3. Применить логику: Используйте условные операторы (if) для проверки значений ячеек и принятия решения об отправке письма.

function sendConditionalEmailsFromSheet() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Список рассылки");
  const data = sheet.getDataRange().getValues(); // Получаем все данные

  // Пропускаем заголовок, начинаем со второй строки
  for (let i = 1; i < data.length; i++) {
    const row = data[i];
    const recipientEmail = row[0]; // Колонка A: Email
    const name = row[1];           // Колонка B: Имя
    const status = row[2];         // Колонка C: Статус задачи
    const dueDate = new Date(row[3]); // Колонка D: Срок выполнения

    // Условие: отправляем письмо, если статус "В работе" и срок истекает до 30 марта 2026
    if (status === "В работе" && dueDate < new Date(2026, 2, 30)) {
      const subject = `Напоминание о задаче: ${name}`;
      const body = `Здравствуйте, ${name}! Ваша задача со статусом "${status}" скоро истекает. Пожалуйста, проверьте ее актуальность.`;
      
      MailApp.sendEmail(recipientEmail, subject, body);
    }
  }
}

Работа с несколькими получателями, динамическим контентом и шаблонами писем

При работе с Google Таблицами вы легко можете отправлять письма нескольким получателям, просто перечисляя их адреса в отдельной колонке или используя массив. Динамический контент создается путем вставки значений из ячеек таблицы непосредственно в тело или тему письма, как показано в примере выше (Здравствуйте, ${name}!).

Для более сложных сценариев можно использовать HTML-шаблоны, хранящиеся в Google Документах или прямо в скрипте. Вы можете загрузить шаблон, заменить в нем "плейсхолдеры" (например, {{ИМЯ}}, {{ЗАДАЧА}}) на актуальные данные из таблицы и отправить персонализированное HTML-письмо с помощью GmailApp.sendEmail.

Отправка писем на основе значений ячеек в Google Таблицах: условия и логика

Продолжая тему динамических рассылок, одним из наиболее мощных применений Google Apps Script является возможность отправлять письма на основе конкретных условий, определенных значениями в ячейках Google Таблиц. Это позволяет создавать высокоцелевые и контекстуально релевантные сообщения, автоматизируя процессы, которые ранее требовали ручной проверки данных.

Для реализации такой логики необходимо выполнить следующие шаги:

  1. Чтение данных: Получите доступ к нужной Google Таблице и листу, а затем прочитайте диапазон ячеек, содержащий необходимые данные (например, список клиентов, статус заказа, даты).

  2. Определение условий: В цикле переберите строки данных и для каждой строки проверьте значения в определенных столбцах. Условия могут быть любыми: если статус = 'Завершено', если сумма > 1000, если дата просрочена и т.д.

  3. Условная отправка: Если условие выполняется, сформируйте и отправьте письмо, используя данные из текущей строки для персонализации.

Пример кода для отправки письма, если статус заказа в таблице равен «Готов к отправке»:

function sendOrderReadyEmails() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Заказы');
  const data = sheet.getDataRange().getValues(); // Получаем все данные

  // Предполагаем, что первая строка - это заголовки
  for (let i = 1; i < data.length; i++) {
    const row = data[i];
    const orderId = row[0]; // Столбец A: ID заказа
    const customerEmail = row[1]; // Столбец B: Email клиента
    const orderStatus = row[2]; // Столбец C: Статус заказа
    const customerName = row[3]; // Столбец D: Имя клиента

    if (orderStatus === 'Готов к отправке') {
      const subject = `Ваш заказ #${orderId} готов к отправке!`;
      const body = `Уважаемый(ая) ${customerName},

Ваш заказ #${orderId} успешно собран и готов к отправке.`;
      GmailApp.sendEmail(customerEmail, subject, body);
      // Опционально: обновить статус в таблице, чтобы избежать повторной отправки
      sheet.getRange(i + 1, 3).setValue('Отправлено уведомление');
    }
  }
}

Этот подход позволяет создавать сложные системы уведомлений и рассылок, реагирующие на изменения данных в реальном времени или по расписанию.

Работа с несколькими получателями, динамическим контентом и шаблонами писем

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

Работа с несколькими получателями

Для отправки письма нескольким адресатам, а также для использования полей CC (копия) и BCC (скрытая копия), можно передать список адресов в виде строки, разделенной запятыми, или массива строк. GmailApp.sendEmail поддерживает эти параметры:

function sendToMultipleRecipients() {
  const recipients = 'recipient1@example.com,recipient2@example.com';
  const ccRecipients = ['cc1@example.com', 'cc2@example.com'];
  const bccRecipients = 'bcc@example.com';
  
  GmailApp.sendEmail(recipients, 'Тема письма', 'Текст письма', {
    cc: ccRecipients,
    bcc: bccRecipients
  });
}

Динамический контент и шаблоны писем

Для создания персонализированных писем используйте шаблоны. Шаблон может быть простой строкой с заполнителями, которые затем заменяются актуальными данными. Данные могут поступать из Google Таблиц, Google Форм или других источников.

function sendDynamicEmail() {
  const name = 'Иван';
  const product = 'Премиум-подписка';
  const email = 'ivan@example.com';
  
  let template = 'Здравствуйте, {{name}}! Благодарим вас за приобретение {{product}}.';
  template = template.replace('{{name}}', name);
  template = template.replace('{{product}}', product);
  
  GmailApp.sendEmail(email, 'Ваш заказ', template);
}

Более сложные шаблоны можно хранить в ячейках Google Таблиц или даже в Google Документах, извлекая их содержимое и динамически заполняя данные перед отправкой.

Оптимизация и расширение возможностей: Лимиты, ошибки и внешние API

После освоения персонализированных рассылок важно обратить внимание на аспекты оптимизации и надежности ваших скриптов. Google Apps Script имеет определенные лимиты на отправку писем, которые зависят от типа аккаунта (личный, Workspace). Например, для личных аккаунтов это обычно 100 писем в день, для Workspace — до 1500. Превышение этих квот приводит к ошибкам, поэтому крайне важно внедрять механизмы обработки ошибок, используя конструкции try...catch, и отслеживать оставшиеся лимиты.

Для сценариев, требующих большей гибкости, высокой пропускной способности или расширенной аналитики, можно использовать внешние Email API, такие как SendGrid, Mailgun или Amazon SES. Google Apps Script позволяет взаимодействовать с ними через сервис UrlFetchApp. Это открывает возможности для отправки тысяч писем, использования продвинутых шаблонов и получения детальных отчетов о доставке, эффективно обходя при этом стандартные лимиты GAS и расширяя функциональность.

Понимание и управление лимитами отправки Google Apps Script, а также обработка ошибок

При работе с Google Apps Script крайне важно учитывать ежедневные лимиты на отправку электронной почты, установленные Google. Эти квоты зависят от типа вашей учетной записи: для обычных аккаунтов Gmail они значительно ниже, чем для пользователей Google Workspace. Превышение лимитов приводит к ошибкам и временной блокировке функции отправки.

Для эффективного управления лимитами:

  • Оптимизируйте рассылки: По возможности объединяйте несколько писем в одно или используйте пакетную отправку.

  • Мониторинг: Отслеживайте количество отправленных писем, чтобы не превысить квоту.

  • Альтернативы: В случае необходимости отправки большого объема писем рассмотрите использование внешних Email API, как упоминалось ранее.

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

Пример базовой обработки ошибок:

function sendEmailSafely() {
  try {
    MailApp.sendEmail('получатель@example.com', 'Тема', 'Текст письма');
    Logger.log('Письмо успешно отправлено.');
  } catch (e) {
    Logger.log('Ошибка при отправке письма: ' + e.toString());
    // Дополнительная логика обработки, например, уведомление администратора
  }
}

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

Использование UrlFetchApp для отправки писем через сторонние Email API

Если встроенные лимиты Google Apps Script становятся препятствием для ваших масштабных рассылок или вам требуются более продвинутые функции, такие как детальная аналитика доставки, расширенные шаблоны или улучшенная доставляемость, UrlFetchApp становится вашим незаменимым инструментом. Он позволяет скриптам Google Apps Script взаимодействовать с внешними веб-сервисами и API, включая сторонние Email API (например, SendGrid, Mailgun, Postmark).

Принцип работы прост:

  1. Выбор сервиса: Зарегистрируйтесь в одном из сторонних Email API и получите свой API-ключ.

  2. Формирование запроса: Используйте UrlFetchApp для отправки HTTP-запроса к конечной точке API выбранного сервиса. Запрос обычно включает:

    • URL API: Адрес для отправки писем.

    • Заголовки (Headers): Содержат ваш API-ключ для аутентификации (например, Authorization: Bearer YOUR_API_KEY).

    • Тело запроса (Payload): JSON-объект с информацией о письме (получатели, тема, текст, HTML-контент, вложения).

Пример концепции:

function sendEmailViaExternalApi() {
  const apiUrl = 'https://api.example.com/send'; // URL вашего Email API
  const apiKey = 'ВАШ_API_КЛЮЧ';

  const payload = {
    to: 'получатель@example.com',
    subject: 'Тема письма',
    body: 'Текст письма'
  }; // Структура зависит от API

  const options = {
    method: 'post',
    contentType: 'application/json',
    headers: { 'Authorization': 'Bearer ' + apiKey },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true // Для обработки ошибок
  };

  const response = UrlFetchApp.fetch(apiUrl, options);
  // Обработка ответа и ошибок
}

Использование UrlFetchApp открывает двери к практически неограниченным возможностям по отправке почты, обходя внутренние лимиты Google и предоставляя доступ к профессиональным функциям Email-сервисов.

Заключение

В этом подробном руководстве мы глубоко погрузились в мир автоматизации электронной почты с помощью Google Apps Script. Мы начали с основ MailApp и GmailApp, их отличий и сценариев использования. Далее мы освоили настройку триггеров для автоматических рассылок и рассмотрели продвинутые методы персонализации писем на основе данных из Google Таблиц. Наконец, мы обсудили управление лимитами и возможности интеграции с внешними Email API через UrlFetchApp.

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

Метки:

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

Реклама
Как правильно использовать блочные комментарии в Google Apps Script для чистого кода?
В мире разработки программного обеспечения, где чистота и поддерживаемость кода ценятся не меньше его функциональности, комментарии играют ключевую роль.
  •  21
  •   2026
Фриланс вакансии Google Apps Script: Исчерпывающее руководство по поиску проектов, требований и платформы для заработка
В современном мире, где цифровая трансформация и автоматизация бизнес-процессов становятся ключевыми факторами успеха, спрос на специалистов, способных оптимизировать рабочие процессы, постоянно растет.
  •  21
  •   2026
Как эффективно использовать прослушиватель событий в Apps Script: Руководство по триггерам?
В современном цифровом мире, где Google Workspace стал неотъемлемой частью повседневной работы, эффективность и автоматизация играют ключевую роль.
  •  21
  •   2026