Как автоматизировать Gmail и Google Sheets с помощью Apps Script?

Что такое Google Apps Script и его возможности?

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

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

ChatGPT

Google AI

Grok

Perplexity

Преимущества автоматизации Gmail и Google Sheets

Автоматизация Gmail и Google Sheets открывает множество преимуществ:

• Экономия времени: Автоматизация повторяющихся задач освобождает время для более важных дел.
• Повышение точности: Скрипты выполняют задачи последовательно и без ошибок, в отличие от ручного труда.
• Улучшение организации данных: Данные из Gmail можно автоматически структурировать в Google Sheets для анализа и отчетности.
• Персонализация: Автоматические рассылки можно персонализировать, используя данные из Google Sheets.
• Интеграция: Возможность интеграции с другими сервисами Google Workspace и сторонними сервисами.

Настройка окружения Apps Script для работы с Gmail и Google Sheets

1. Откройте Google Sheets или Gmail.
2. В Google Sheets выберите Инструменты > Редактор скриптов. В Gmail – нажмите на три точки в правом верхнем углу и выберите Редактор скриптов.
3. Откроется редактор Apps Script. Здесь вы будете писать свой код.
4. Предоставьте скрипту необходимые разрешения для доступа к Gmail и Google Sheets. При первом запуске скрипта Google запросит подтверждение доступа к вашим данным.

Автоматизация Gmail с помощью Apps Script

Получение доступа к Gmail API в Apps Script

Для работы с Gmail необходимо использовать сервис GmailApp. Этот сервис предоставляет методы для доступа ко всем функциям Gmail API. Он не требует дополнительной установки, так как является встроенным сервисом Apps Script.

Чтение писем из Gmail (поиск, фильтрация)

Для чтения писем используется метод GmailApp.search(). Он позволяет искать письма по различным критериям, таким как тема, отправитель, дата и т.д. Результатом является массив объектов GmailThread, представляющих собой цепочки писем.

/**
 * @param {string} query Строка запроса для поиска писем.
 * @return {GmailThread[]} Массив объектов GmailThread.
 */
function searchEmails(query: string): GoogleAppsScript.Gmail.GmailThread[] {
  const threads: GoogleAppsScript.Gmail.GmailThread[] = GmailApp.search(query);
  return threads;
}

// Пример использования
const threads: GoogleAppsScript.Gmail.GmailThread[] = searchEmails('from:example@example.com subject:"Order Confirmation"');
threads.forEach(thread => {
  const messages: GoogleAppsScript.Gmail.GmailMessage[] = thread.getMessages();
  messages.forEach(message => {
    Logger.log(message.getSubject());
  });
});

Отправка писем через Apps Script

Для отправки писем используется метод GmailApp.sendEmail(). Он позволяет указать получателя, тему, текст письма и другие параметры. Можно отправлять как простые текстовые письма, так и письма в формате HTML.

/**
 * @param {string} recipient Email адрес получателя.
 * @param {string} subject Тема письма.
 * @param {string} body Текст письма.
 * @param {object} options Дополнительные параметры отправки (например, htmlBody).
 */
function sendEmail(recipient: string, subject: string, body: string, options?: object): void {
  GmailApp.sendEmail(recipient, subject, body, options);
}

// Пример использования
sendEmail('recipient@example.com', 'Hello from Apps Script', 'This is a test email.');
sendEmail('recipient@example.com', 'HTML Email', 'This is a test email.', {htmlBody: '<h1>Hello</h1><p>This is <i>HTML</i> content.</p>'});

Автоматическая обработка входящих писем (примеры скриптов)

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

/**
 * Функция, которая запускается при получении нового письма.
 */
function onNewEmail(): void {
  const threads: GoogleAppsScript.Gmail.GmailThread[] = GmailApp.search('is:unread');
  threads.forEach(thread => {
    const messages: GoogleAppsScript.Gmail.GmailMessage[] = thread.getMessages();
    messages.forEach(message => {
      if (!message.isUnread()) return; // Пропускаем прочитанные сообщения.

      const sender: string = message.getFrom();
      const subject: string = message.getSubject();
      const date: Date = message.getDate();

      // Записываем данные в Google Sheets (пример)
      const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
      const sheet: GoogleAppsScript.Spreadsheet.Sheet = ss.getSheetByName('EmailData');
      sheet.appendRow([date, sender, subject]);

      message.markRead(); // Отмечаем письмо как прочитанное.
    });
  });
}

Интеграция Gmail и Google Sheets: перенос данных

Запись данных из Gmail в Google Sheets

Используя SpreadsheetApp и GmailApp, можно извлекать информацию из писем и записывать ее в Google Sheets. Это позволяет создавать отчеты, анализировать данные и автоматизировать рутинные задачи.

Примеры: сохранение информации об отправителе, дате, теме письма

Как показано в предыдущем примере, можно легко извлечь информацию об отправителе (message.getFrom()), дате (message.getDate()) и теме (message.getSubject()) письма и записать ее в таблицу Google Sheets.

Перенос данных из Google Sheets в Gmail для персонализированных рассылок

Можно создать скрипт, который будет читать данные из Google Sheets (например, имена и адреса электронной почты) и использовать их для отправки персонализированных писем через Gmail.

/**
 * Отправляет персонализированные письма, используя данные из Google Sheets.
 */
function sendPersonalizedEmails(): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = ss.getSheetByName('Subscribers');
  const data: any[][] = sheet.getDataRange().getValues();

  // Предполагаем, что первая строка - заголовки
  for (let i = 1; i < data.length; i++) {
    const email: string = data[i][0]; // Предполагаем, что email находится в первом столбце
    const name: string = data[i][1]; // Предполагаем, что имя находится во втором столбце

    const subject: string = 'Personalized Greeting';
    const body: string = `Dear ${name},

Thank you for subscribing to our newsletter!`;

    GmailApp.sendEmail(email, subject, body);
  }
}

Практические примеры автоматизации Gmail и Google Sheets

Пример 1: Автоматическое добавление в Google Sheets данных из писем с заказами

Скрипт анализирует входящие письма с заказами (например, по теме письма) и извлекает необходимую информацию (номер заказа, дата, товары, сумма) и добавляет ее в таблицу Google Sheets.

Пример 2: Создание отчетов о прочитанных/непрочитанных письмах в Google Sheets

Скрипт проверяет почтовый ящик и создает отчет в Google Sheets, содержащий информацию о количестве прочитанных и непрочитанных писем, отправителях и темах.

Пример 3: Отправка персонализированных приветственных писем новым подписчикам (данные из Google Sheets)

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

Расширенные возможности и оптимизация Apps Script для Gmail и Google Sheets

Обработка ошибок и логирование в Apps Script

Для отладки и мониторинга скриптов необходимо использовать обработку ошибок (try...catch) и логирование (Logger.log()). Это поможет выявлять проблемы и отслеживать работу скрипта.

try {
  // Код, который может вызвать ошибку
  GmailApp.sendEmail('invalid-email', 'Test', 'Test');
} catch (e) {
  Logger.log(`Error: ${e.toString()}`);
}

Оптимизация производительности скриптов для работы с большими объемами данных

При работе с большим количеством писем или строк в Google Sheets важно оптимизировать скрипт. Например, можно использовать пакетную обработку данных и избегать лишних вызовов API.

Использование триггеров для автоматического запуска скриптов (по времени, при изменении таблицы)

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

Рекомендации по безопасности при работе с Gmail API

• Предоставляйте скрипту только необходимые разрешения.
• Не храните конфиденциальные данные (пароли, ключи API) в коде скрипта.
• Регулярно проверяйте код скрипта на наличие уязвимостей.
• Используйте OAuth 2.0 для авторизации доступа к Gmail API.