Google Apps Script: Как отправить данные?

  •   
  •   22520
  •   10 мин
  •   347

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

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

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

Обзор основных способов отправки данных (Email, Spreadsheet, Web Apps, внешние API)

Google Apps Script предоставляет несколько способов для отправки данных, каждый из которых подходит для различных задач:

  • Email: Отправка электронных писем с использованием MailApp или GmailApp. Это полезно для отправки уведомлений, отчетов или персонализированных сообщений.
  • Spreadsheet: Запись данных непосредственно в Google Таблицы с использованием SpreadsheetApp. Подходит для хранения, анализа и визуализации данных.
  • Web Apps: Создание веб-приложений, которые могут принимать запросы и возвращать данные в формате JSON. Это позволяет создавать API для интеграции с другими системами.
  • Внешние API: Отправка данных на сторонние API с использованием UrlFetchApp. Это позволяет интегрировать Google Apps Script с различными веб-сервисами и платформами.

Необходимые разрешения и авторизация

Перед отправкой данных с помощью Google Apps Script необходимо предоставить скрипту необходимые разрешения. При первом запуске скрипта, требующего доступа к определенным сервисам (например, Gmail или Google Drive), Google запросит у пользователя разрешение на доступ. Эти разрешения хранятся и используются при последующих запусках скрипта. Важно внимательно ознакомиться с запрашиваемыми разрешениями, чтобы убедиться, что скрипт не запрашивает доступ к данным, которые ему не нужны. Также, при работе с внешними API, может потребоваться аутентификация и авторизация с использованием API-ключей или протокола OAuth.

Отправка данных по электронной почте (Email)

Использование MailApp.sendEmail() для отправки простых сообщений

Самый простой способ отправки электронных писем в Google Apps Script — использование метода MailApp.sendEmail(). Этот метод принимает несколько параметров, включая адрес получателя, тему и текст письма. Пример:

/**
 * Отправляет простое текстовое письмо.
 * @param {string} recipient - Адрес электронной почты получателя.
 * @param {string} subject - Тема письма.
 * @param {string} body - Текст письма.
 */
function sendSimpleEmail(recipient: string, subject: string, body: string): void {
  MailApp.sendEmail(recipient, subject, body);
}

// Пример использования
sendSimpleEmail('example@example.com', 'Привет!', 'Это простое тестовое письмо.');

Отправка HTML-писем с использованием MailApp.sendEmail()

Для отправки более сложных писем с форматированием можно использовать HTML-письма. В MailApp.sendEmail() можно передать параметр htmlBody, содержащий HTML-код письма. Это позволяет использовать различные стили, изображения и ссылки. Пример:

/**
 * Отправляет HTML-письмо.
 * @param {string} recipient - Адрес электронной почты получателя.
 * @param {string} subject - Тема письма.
 * @param {string} htmlBody - HTML-код письма.
 */
function sendHtmlEmail(recipient: string, subject: string, htmlBody: string): void {
  MailApp.sendEmail({
    to: recipient,
    subject: subject,
    htmlBody: htmlBody
  });
}

// Пример использования
const html = '<h1>Привет!</h1><p>Это <b>HTML</b> письмо.</p><img src="https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png">';
sendHtmlEmail('example@example.com', 'HTML письмо', html);

Прикрепление файлов к письмам (из Google Drive или Blob)

К письмам можно прикреплять файлы из Google Drive или Blob (Binary Large Object). Для этого необходимо получить объект File или Blob и передать его в параметре attachments метода MailApp.sendEmail(). Пример:

/**
 * Отправляет письмо с прикрепленным файлом.
 * @param {string} recipient - Адрес электронной почты получателя.
 * @param {string} subject - Тема письма.
 * @param {string} body - Текст письма.
 * @param {string} fileId - ID файла в Google Drive.
 */
function sendEmailWithAttachment(recipient: string, subject: string, body: string, fileId: string): void {
  const file = DriveApp.getFileById(fileId);
  MailApp.sendEmail({
    to: recipient,
    subject: subject,
    body: body,
    attachments: [file]
  });
}

// Пример использования
const fileId = '1234567890abcdefghijklmnopqrstuvwxyz'; // Замените на реальный ID файла
sendEmailWithAttachment('example@example.com', 'Письмо с файлом', 'Пожалуйста, ознакомьтесь с прикрепленным файлом.', fileId);

Решение проблем с доставкой и ограничениями отправки

При отправке электронных писем через Google Apps Script могут возникать проблемы с доставкой. Некоторые письма могут попадать в спам или не доставляться из-за ограничений на количество отправляемых писем. Чтобы избежать этих проблем, рекомендуется:

  • Убедиться, что адрес отправителя правильно настроен.
  • Избегать отправки массовых рассылок без предварительной настройки.
  • Соблюдать ограничения на количество отправляемых писем (бесплатные аккаунты имеют более строгие ограничения).
  • Использовать SPF и DKIM для подтверждения подлинности отправителя.

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

Запись данных в Google Таблицы (Spreadsheet)

Использование SpreadsheetApp для доступа к таблицам

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

/**
 * Записывает данные в Google Таблицу.
 * @param {string} spreadsheetId - ID таблицы.
 * @param {string} sheetName - Название листа.
 * @param {number} row - Номер строки.
 * @param {number} column - Номер столбца.
 * @param {any} value - Значение для записи.
 */
function writeDataToSheet(spreadsheetId: string, sheetName: string, row: number, column: number, value: any): void {
  const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  const sheet = spreadsheet.getSheetByName(sheetName);
  sheet.getRange(row, column).setValue(value);
}

// Пример использования
const spreadsheetId = 'abcdefghijklmnopqrstuvwxyz1234567890'; // Замените на реальный ID таблицы
writeDataToSheet(spreadsheetId, 'Лист1', 1, 1, 'Привет, мир!');

Запись данных в ячейки (setValue(), setValues())

Для записи данных в отдельные ячейки используется метод setValue(). Для записи массива данных в диапазон ячеек используется метод setValues(). Метод setValues() более эффективен при записи большого количества данных, так как он выполняет одну операцию записи вместо множества отдельных операций. Пример:

/**
 * Записывает массив данных в Google Таблицу.
 * @param {string} spreadsheetId - ID таблицы.
 * @param {string} sheetName - Название листа.
 * @param {number} startRow - Номер начальной строки.
 * @param {number} startColumn - Номер начального столбца.
 * @param {any[][]} values - Двумерный массив данных для записи.
 */
function writeDataToSheetRange(spreadsheetId: string, sheetName: string, startRow: number, startColumn: number, values: any[][]): void {
  const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  const sheet = spreadsheet.getSheetByName(sheetName);
  const numRows = values.length;
  const numColumns = values[0].length;
  sheet.getRange(startRow, startColumn, numRows, numColumns).setValues(values);
}

// Пример использования
const spreadsheetId = 'abcdefghijklmnopqrstuvwxyz1234567890'; // Замените на реальный ID таблицы
const data = [
  ['Имя', 'Возраст', 'Город'],
  ['Иван', 30, 'Москва'],
  ['Мария', 25, 'Санкт-Петербург']
];
writeDataToSheetRange(spreadsheetId, 'Лист1', 1, 1, data);

Добавление новых строк с данными (appendRow())

Для добавления новых строк с данными в конец таблицы используется метод appendRow(). Этот метод принимает массив значений, которые будут записаны в новую строку. Пример:

Реклама
/**
 * Добавляет новую строку данных в Google Таблицу.
 * @param {string} spreadsheetId - ID таблицы.
 * @param {string} sheetName - Название листа.
 * @param {any[]} rowData - Массив данных для записи в новую строку.
 */
function appendDataToSheet(spreadsheetId: string, sheetName: string, rowData: any[]): void {
  const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  const sheet = spreadsheet.getSheetByName(sheetName);
  sheet.appendRow(rowData);
}

// Пример использования
const spreadsheetId = 'abcdefghijklmnopqrstuvwxyz1234567890'; // Замените на реальный ID таблицы
const newRow = ['Петр', 40, 'Киев'];
appendDataToSheet(spreadsheetId, 'Лист1', newRow);

Форматирование данных при записи (даты, числа, текст)

При записи данных в Google Таблицы можно форматировать их, например, устанавливать формат даты, числа или текста. Для этого используются методы setNumberFormat() и setDataValidation(). Пример:

/**
 * Форматирует дату в Google Таблице.
 * @param {string} spreadsheetId - ID таблицы.
 * @param {string} sheetName - Название листа.
 * @param {number} row - Номер строки.
 * @param {number} column - Номер столбца.
 * @param {string} format - Формат даты (например, 'yyyy-MM-dd').
 */
function formatDateInSheet(spreadsheetId: string, sheetName: string, row: number, column: number, format: string): void {
  const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  const sheet = spreadsheet.getSheetByName(sheetName);
  sheet.getRange(row, column).setNumberFormat(format);
}

// Пример использования
const spreadsheetId = 'abcdefghijklmnopqrstuvwxyz1234567890'; // Замените на реальный ID таблицы
formatDateInSheet(spreadsheetId, 'Лист1', 1, 1, 'yyyy-MM-dd');

Отправка данных через Web Apps (как API)

Создание Web App в Google Apps Script

Google Apps Script позволяет создавать веб-приложения, которые могут принимать HTTP-запросы и возвращать данные. Для этого необходимо создать функцию doGet() или doPost(), которая будет обрабатывать запросы. Пример:

/**
 * Обрабатывает GET-запросы.
 * @param {GoogleAppsScript.Events.DoGet} e - Объект события GET-запроса.
 * @return {GoogleAppsScript.HTML.HtmlOutput} - HTML-вывод.
 */
function doGet(e: GoogleAppsScript.Events.DoGet): GoogleAppsScript.HTML.HtmlOutput {
  return HtmlService.createHtmlOutput('<h1>Привет от Web App!</h1>');
}

Получение параметров запроса (GET и POST)

Параметры запроса передаются в функцию doGet() или doPost() через объект события e. Для получения параметров используется свойство e.parameter. Пример:

/**
 * Обрабатывает GET-запросы с параметрами.
 * @param {GoogleAppsScript.Events.DoGet} e - Объект события GET-запроса.
 * @return {GoogleAppsScript.Content.TextOutput} - Текстовый вывод.
 */
function doGetWithParams(e: GoogleAppsScript.Events.DoGet): GoogleAppsScript.Content.TextOutput {
  const name = e.parameter.name || 'Гость';
  return ContentService.createTextOutput(`Привет, ${name}!`).setMimeType(ContentService.MimeType.TEXT);
}

Обработка данных и формирование ответа в формате JSON

Для возврата данных в формате JSON используется класс ContentService. Необходимо создать объект JSON и преобразовать его в строку с помощью метода JSON.stringify(). Пример:

/**
 * Обрабатывает GET-запросы и возвращает JSON.
 * @param {GoogleAppsScript.Events.DoGet} e - Объект события GET-запроса.
 * @return {GoogleAppsScript.Content.TextOutput} - JSON-вывод.
 */
function doGetJson(e: GoogleAppsScript.Events.DoGet): GoogleAppsScript.Content.TextOutput {
  const data = {
    message: 'Привет от Web App!',
    timestamp: new Date().toISOString()
  };
  const json = JSON.stringify(data);
  return ContentService.createTextOutput(json).setMimeType(ContentService.MimeType.JSON);
}

Развертывание Web App и настройка прав доступа

После создания Web App необходимо развернуть его, чтобы сделать доступным для других пользователей или систем. При развертывании необходимо указать, кто может запускать приложение (только вы или любой пользователь) и от чьего имени будет выполняться код (от имени пользователя, запускающего приложение, или от имени владельца приложения). Важно правильно настроить права доступа, чтобы обеспечить безопасность данных и избежать несанкционированного доступа.

Отправка данных во внешние API (с использованием UrlFetchApp)

Использование UrlFetchApp.fetch() для отправки запросов

Для отправки данных во внешние API используется класс UrlFetchApp. Метод fetch() позволяет отправлять HTTP-запросы различных типов (GET, POST, PUT, DELETE) и получать ответы от API. Пример:

/**
 * Отправляет GET-запрос к внешнему API.
 * @param {string} url - URL API.
 * @return {string} - Ответ от API.
 */
function fetchDataFromApi(url: string): string {
  const response = UrlFetchApp.fetch(url);
  return response.getContentText();
}

// Пример использования
const apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';
const data = fetchDataFromApi(apiUrl);
Logger.log(data);

Методы HTTP-запросов (GET, POST, PUT, DELETE)

UrlFetchApp поддерживает различные методы HTTP-запросов, каждый из которых используется для определенных целей:

  • GET: Получение данных с сервера.
  • POST: Отправка данных на сервер для создания нового ресурса.
  • PUT: Отправка данных на сервер для обновления существующего ресурса.
  • DELETE: Удаление ресурса на сервере.

Для выбора метода запроса необходимо передать его в параметре method объекта options метода UrlFetchApp.fetch(). Пример:

/**
 * Отправляет POST-запрос к внешнему API.
 * @param {string} url - URL API.
 * @param {object} payload - Данные для отправки.
 * @return {string} - Ответ от API.
 */
function postDataToApi(url: string, payload: object): string {
  const options: GoogleAppsScript.URL_Fetch.URLFetchRequestOptions = {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify(payload)
  };
  const response = UrlFetchApp.fetch(url, options);
  return response.getContentText();
}

// Пример использования
const apiUrl = 'https://jsonplaceholder.typicode.com/posts';
const data = {
  title: 'foo',
  body: 'bar',
  userId: 1
};
const response = postDataToApi(apiUrl, data);
Logger.log(response);

Передача данных в теле запроса (JSON, form data)

Данные в теле запроса могут быть переданы в различных форматах, наиболее распространенными являются JSON и form data. Для передачи данных в формате JSON необходимо установить заголовок Content-Type в значение application/json и преобразовать данные в строку с помощью метода JSON.stringify(). Для передачи данных в формате form data необходимо создать объект FormData и передать его в параметре payload метода UrlFetchApp.fetch(). Пример передачи JSON представлен в предыдущем блоке кода.

Обработка ответов от API (коды статуса, заголовки, тело)

После отправки запроса необходимо обработать ответ от API. Ответ содержит код статуса, заголовки и тело. Код статуса указывает на результат выполнения запроса (например, 200 OK, 400 Bad Request, 500 Internal Server Error). Заголовки содержат дополнительную информацию об ответе. Тело содержит данные, возвращенные API. Пример:

/**
 * Отправляет GET-запрос к внешнему API и обрабатывает ответ.
 * @param {string} url - URL API.
 */
function fetchAndProcessApiResponse(url: string): void {
  const response = UrlFetchApp.fetch(url);
  const statusCode = response.getResponseCode();
  const headers = response.getAllHeaders();
  const body = response.getContentText();

  Logger.log(`Status Code: ${statusCode}`);
  Logger.log(`Headers: ${JSON.stringify(headers)}`);
  Logger.log(`Body: ${body}`);
}

// Пример использования
const apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';
fetchAndProcessApiResponse(apiUrl);

Аутентификация и авторизация (API ключи, OAuth)

Для доступа к некоторым API требуется аутентификация и авторизация. Аутентификация подтверждает личность пользователя, а авторизация определяет, какие ресурсы пользователь имеет право использовать. Наиболее распространенными способами аутентификации и авторизации являются API-ключи и протокол OAuth. API-ключи — это секретные ключи, которые передаются вместе с запросом. OAuth — это более сложный протокол, который позволяет пользователям предоставлять доступ к своим данным без передачи пароля. Пример использования API-ключа:

/**
 * Отправляет GET-запрос к API с API-ключом.
 * @param {string} url - URL API.
 * @param {string} apiKey - API-ключ.
 * @return {string} - Ответ от API.
 */
function fetchDataFromApiWithApiKey(url: string, apiKey: string): string {
  const options: GoogleAppsScript.URL_Fetch.URLFetchRequestOptions = {
    headers: {
      'X-API-Key': apiKey
    }
  };
  const response = UrlFetchApp.fetch(url, options);
  return response.getContentText();
}

// Пример использования
const apiUrl = 'https://api.example.com/data';
const apiKey = 'YOUR_API_KEY'; // Замените на реальный API-ключ
const data = fetchDataFromApiWithApiKey(apiUrl, apiKey);
Logger.log(data);
Метки:

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

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