Google Apps Script — быстрое руководство и практические примеры

Кратко

Google Apps Script — это облачная платформа для автоматизации и расширения Google Workspace. В нескольких шагах вы сможете отправлять письма, расширять Google Sheets и создавать простые веб‑приложения. В статье есть пример «Hello World», инструкции по включению API, чек‑листы для разных ролей и практические советы по отладке.

Важно: перед запуском скрипта вам потребуется дать разрешения от своей учётной записи Google. Если появится предупреждение «приложение не подтверждено», можно продолжить, если вы сами написали код.

Что такое Google Apps Script и зачем он нужен

Google Apps Script (часто сокращённо — Google Script) — это платформа разработки на основе JavaScript, которая даёт доступ к API сервисов Google (Gmail, Google Sheets, Google Docs, Drive, Calendar и другим). Коротко о возможностях:

• Автоматизация рутинных задач (отправка почты, перенос данных, планирование задач).
• Создание собственных функций для Google Sheets.
• Интеграция между сервисами (например, формы → таблицы → почта).
• Быстрая разработка простых веб‑приложений, доступных в браузере.
• Расширения и надстройки для Gmail и других сервисов.

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

Что можно сделать прямо сейчас

Ниже — краткий перечень типичных сценариев применения:

• Создать пользовательские функции в Google Sheets (аналог формул).
• Интегрировать данные из Google Sheets или Google Docs с Gmail для массовой рассылки.
• Собрать данные Google Analytics в табличный дашборд.
• Добавить собственное меню в Google Docs/Sheets для запуска макросов.
• Автоматически архивировать/помечать письма в Gmail по правилам.
• Деплоить простые веб‑формы и web‑hooks для внешних интеграций.

Написание первого Google Apps Script — пример “Hello World”

Этот пример отправляет письмо из вашего аккаунта Gmail через скрипт.

Шаги для запуска:

1. Откройте браузер и введите в адресную строку script.google.com.
2. Авторизуйтесь в Google, если ещё не вошли.
3. В редакторе Google Apps Script нажмите Новый сценарий (New script) или Создать проект.
4. В поле с названием по умолчанию замените его на My First Script.

Удалите весь код в окне редактора и вставьте следующий блок кода (обязательно сохраните файл перед запуском):

function SendAnEmail() {  
  
  // Set the recipient email address  
  var email = 'xxxxx@yahoo.com'  
  
  // Create the email subject line.  
  var subject = 'This is my first script!';  
  
  // Create the email body.  
  var body = 'Hello, world!';  
  
  // Send an email  
  GmailApp.sendEmail(email, subject, body);  
}  

Нажмите значок дискеты, чтобы сохранить (Save), затем нажмите кнопку запуска (Run). При первом запуске система запросит права доступа — подтвердите их. Если увидите сообщение о том, что приложение не подтверждено, откройте «Дополнительно» и выберите «Перейти к My First Script (небезопасно)» только если вы уверены в коде.

Вот как будет выглядеть входящее письмо, отправленное скриптом:

Этот простой пример использует глобальный объект GmailApp для отправки сообщения. Аналогично существуют SpreadsheetApp, DocumentApp, DriveApp и другие глобальные объекты.

Где искать редактор и как подключаться внутри сервисов Google

Редактор скриптов доступен напрямую из многих приложений Workspace. Например, в Google Sheets откройте меню Инструменты → Редактор сценариев (Tools → Script editor) или в новых интерфейсах: Расширения → Apps Script.

Из Google Docs доступ так же: Инструменты → Редактор сценариев. Это удобно: вы можете писать код прямо в контексте документа или таблицы и обращаться к ним через API.

Вы также можете разрабатывать дополнения (add‑ons) для Gmail — они расширяют интерфейс почты (например, добавляют кнопку в окно написания письма или автоматизируют архивацию). Для этого в Gmail включите режим разработчика дополнений: Настройки → Дополнения → включите «Разработческие дополнения для моей учётной записи» и подтвердите в всплывающем окне.

Создание полноценного дополнения требует дополнительного изучения и публикации в G Suite Marketplace, но для тестирования и внутренних сценариев этого достаточно.

Доступ к расширенным API сервисов Google

Если вам нужны дополнительные методы сервисов (например, Google Analytics API), включите Advanced Google services в редакторе:

1. В редакторе скриптов откройте Ресурсы → Advanced Google services (или «Дополнительные сервисы Google»).
2. В списке включите требуемый сервис (например, Google Analytics API).
3. Нажмите ссылку Google Cloud Platform API Dashboard внизу диалога и в консоли GCP нажмите Enable APIs and Services, найдите нужный API и включите его.

После включения API единожды сохраните ссылку на Reference documentation — там приведены примеры вызовов и синтаксис, который пригодится при интеграции.

В библиотеке API видно, сколько сервисов доступно — их действительно много, и большинство можно подключить к своему сценарию.

Практические рекомендации и лучшие практики

Следующие советы помогут писать надёжные и поддерживаемые сценарии.

• Разделяйте логику: пользовательский интерфейс (меню/формы) отдельно от бизнес‑логики и взаимодействия с API.
• Обрабатывайте ошибки: используйте try/catch и логируйте сообщения через Logger.log() или отправляйте отчёты по ошибкам на e‑mail.
• Минимизируйте количество вызовов к API: например, при работе с таблицей считывайте диапазон одной операцией, а не по ячейке.
• Используйте триггеры (временные — time‑based, или onEdit/onOpen) для автоматического запуска задач.
• Контролируйте квоты и лимиты: у каждого сервиса есть ограничения по вызовам и по времени выполнения. Для тяжёлых задач используйте пакетную обработку.
• Безопасность: не храните секреты в коде; если нужно использовать OAuth‑клиенты или сервисные аккаунты, следуйте рекомендациям Google Cloud.

Краткая шпаргалка по глобальным объектам:

• GmailApp — отправка и управление почтой.
• SpreadsheetApp — работа с Google Sheets.
• DocumentApp — управление Google Docs.
• DriveApp — доступ к файлам на Google Диске.
• CalendarApp — работа с календарём.

Когда Google Apps Script не подойдёт

• Для задач с низкой задержкой и высокими требованиями к производительности лучше подойдёт собственный сервер или облачная функция (Cloud Functions, Cloud Run).
• Если требуется длительное выполнение задач (несколько часов), скрипт с ограничением времени выполнения может прерваться. В таких случаях используйте облачные очереди и фоновые сервисы.
• Для обработки больших объёмов данных (терабайты) лучше применять специализированные решения (BigQuery, Dataflow).

Альтернативы и интеграции

• Если вам нужен более мощный бэкенд — используйте Google Cloud Functions / Cloud Run с OAuth и Pub/Sub.
• Для автоматизаций без кода подойдёт Google Apps Script вместе с Google Workspace Add‑ons или внешние сервисы вроде Zapier / Make (Integromat).
• При необходимости CI/CD для скриптов применяют clasp (Command Line Apps Script Projects) — инструмент для локальной разработки и деплоя.

Мини‑методология создания прикладного скрипта (5 шагов)

1. Определите цель и входные данные (что должно быть автоматизировано).
2. Подготовьте тестовые данные в Google Sheets или тестовом аккаунте.
3. Напишите минимальный рабочий прототип (MVP) в редакторе Apps Script.
4. Настройте права доступа и тестовые триггеры.
5. Протестируйте крайние случаи и задокументируйте использование для конечных пользователей.

Чек‑лист по ролям

Для разработчика:

• Определены входы и выходы.
• Настроен репозиторий или clasp для версионирования.
• Обработаны ошибки и логи.
• Тесты на основные сценарии.

Для администратора Workspace:

• Разрешены необходимые API в GCP.
• Оценены квоты и лимиты.
• Настроены аккаунты для запуска (по необходимости сервисный аккаунт).

Для конечного пользователя:

• Инструкции по запуску и доступу.
• Разъяснены возможные предупреждения безопасности при авторизации.

Чек‑листы: пример шаблона для документации (таблица)

Решение: выбор подхода (диаграмма)

flowchart TD
  A[Нужно ли автоматизировать задачу?] -->|Да| B{Требует ли задача длительного выполнения '>6 мин'?}
  B -->|Да| C[Использовать Cloud Functions / Cloud Run]
  B -->|Нет| D{Требуется доступ к Google Workspace 'Sheets, Gmail'?}
  D -->|Да| E[Использовать Google Apps Script]
  D -->|Нет| C
  A -->|Нет| F[Рассмотреть ручную процедуру или no-code]

Отладка и тестирование

• Logger.log(), console.log() и Stackdriver (Cloud Logging) помогут диагностировать поведение.
• Пошагово увеличивайте сложность: сначала функция отправки одного письма, затем — пакетная обработка.
• Тестируйте с учётной записью разработки, чтобы не отправлять реальные письма пользователям на этапе теста.

Примеры расширенных сценариев (идеи для проектов)

• Дашборд аналитики: периодический сбор данных Google Analytics → Google Sheets → визуализация в таблице.
• Авто‑резюме заявок: форма Google Forms собирает отклики, скрипт анализирует содержание и отправляет персонализированное письмо.
• Периодическая очистка: скрипт архивирует письма старше N дней и сохраняет копии в Drive.

Заключение и краткое резюме

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

Ключевые моменты:

• Начать можно за считанные минуты с простого примера «SendAnEmail».
• Для доступа к дополнительным методам включайте Advanced Google services и соответствующие API в GCP.
• Следите за квотами, логированием и безопасным хранением учётных данных.

ПРИМЕЧАНИЕ: если вы хотите, могу добавить готовый чек‑лист деплоя для организации, примеры использования clasp для локальной разработки и шаблон add‑on для Gmail.