Что такое Google Apps Script: Полное руководство для новичков

Что такое Google Apps Script и для чего он нужен?

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

GAS нужен для автоматизации рутинных задач, таких как сбор данных из Google Analytics в Google Sheets, отправка персонализированных электронных писем, создание отчетов, интеграция с внешними API и многое другое. Он позволяет адаптировать Google Workspace под специфические нужды бизнеса, значительно повышая эффективность работы.

Преимущества использования Google Apps Script

Простота изучения: Основан на JavaScript, широко распространенном и относительно простом языке.

Интеграция с Google Workspace: Бесшовная интеграция с сервисами Google обеспечивает доступ ко всем необходимым данным и функциям.

Облачная платформа: Скрипты хранятся и выполняются в облаке, что избавляет от необходимости устанавливать и поддерживать дополнительное ПО.

Автоматизация: Позволяет автоматизировать широкий спектр задач, экономя время и ресурсы.

Расширяемость: Можно создавать пользовательские функции, веб-приложения и интеграции с внешними сервисами.

Бесплатность: Использование Google Apps Script не требует дополнительных затрат, помимо подписки на Google Workspace (если требуется).

Сравнение Google Apps Script с другими языками программирования

Google Apps Script, будучи основанным на JavaScript, обладает схожим синтаксисом, но предназначен для специфической области – автоматизации Google Workspace. В отличие от JavaScript, выполняемого в браузере или на сервере (Node.js), GAS работает в облаке и предоставляет доступ к API Google Workspace.

Сравнение с другими языками автоматизации, такими как Python или PowerShell, показывает, что GAS выигрывает в простоте интеграции с сервисами Google, но может уступать в универсальности и доступности библиотек для более широкого круга задач.

Начало работы с Google Apps Script

Как открыть редактор Google Apps Script

Есть несколько способов открыть редактор Google Apps Script:

Из Google Sheets, Docs или Forms: Откройте документ, выберите «Инструменты» > «Редактор скриптов».

Через прямую ссылку: Перейдите по адресу script.google.com.

Из Google Drive: Нажмите «Создать» > «Ещё» > «Google Apps Script».

Интерфейс редактора Google Apps Script: основные элементы

Редактор Google Apps Script представляет собой веб-приложение с интуитивно понятным интерфейсом. Основные элементы:

Строка меню: Содержит команды для работы с файлами, редактирования кода, запуска скриптов и отладки.

Панель инструментов: Быстрый доступ к часто используемым функциям, таким как сохранение, запуск, отладка.

Редактор кода: Область для написания и редактирования кода скрипта.

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

Триггеры: Настройка автоматического запуска скрипта по расписанию или при определенных событиях.

Создание и запуск первого скрипта: Hello World!

Откройте редактор Google Apps Script.

Удалите существующий код (если есть).

Вставьте следующий код:

/**
 * Функция, выводящая приветствие в лог.
 */
function helloWorld() {
  /** @type {string} */
  let message = "Hello, World!";
  Logger.log(message);
}

Сохраните скрипт (например, под именем "HelloWorld").

Нажмите кнопку «Выполнить» (значок Play).

При первом запуске потребуется предоставить скрипту разрешения на доступ к вашему аккаунту Google.

Проверьте лог выполнения («Вид» > «Логи») – там должно появиться сообщение "Hello, World!".

Основы программирования на Google Apps Script

Синтаксис JavaScript для Google Apps Script: переменные, типы данных, операторы

Google Apps Script использует синтаксис JavaScript. Основные элементы:

Переменные: Объявляются с помощью let, const или var. Рекомендуется использовать let и const.

Типы данных: Основные типы данных: string, number, boolean, object, array, null, undefined.

Операторы: Арифметические (+, -,
*, /), сравнения (==, !=, >, <, >=, <=), логические (&&, ||, !), присваивания (=, +=, -= и т.д.).

Пример:

/**
 * Пример работы с переменными и типами данных.
 */
function exampleVariables() {
  /** @type {string} */
  let name = "John Doe";
  /** @type {number} */
  const age = 30;
  /** @type {boolean} */
  let isStudent = false;
  
  Logger.log("Name: " + name);
  Logger.log("Age: " + age);
  Logger.log("Is student: " + isStudent);
}

Условные операторы (if, else if, else)

Условные операторы позволяют выполнять код в зависимости от заданных условий.

Пример:

/**
 * Пример использования условных операторов.
 * @param {number} score - Оценка студента.
 * @returns {string} - Оценка в виде строки.
 */
function getGrade(score) {
  /** @type {string} */
  let grade;
  
  if (score >= 90) {
    grade = "A";
  } else if (score >= 80) {
    grade = "B";
  } else if (score >= 70) {
    grade = "C";
  } else if (score >= 60) {
    grade = "D";
  } else {
    grade = "F";
  }
  
  return grade;
}

Циклы (for, while, do…while)

Циклы позволяют повторять блок кода несколько раз.

Пример:

/**
 * Пример использования цикла for.
 */
function printNumbers() {
  for (let i = 1; i <= 5; i++) {
    Logger.log(i);
  }
}

/**
 * Пример использования цикла while.
 */
function countToTen() {
  /** @type {number} */
  let i = 1;
  while (i <= 10) {
    Logger.log(i);
    i++;
  }
}

Функции: определение и вызов

Функции – это блоки кода, которые выполняют определенную задачу. Они могут принимать аргументы и возвращать значения.

Пример:

/**
 * Функция, складывающая два числа.
 * @param {number} a - Первое число.
 * @param {number} b - Второе число.
 * @returns {number} - Сумма двух чисел.
 */
function add(a, b) {
  return a + b;
}

/**
 * Пример вызова функции.
 */
function useAddFunction() {
  /** @type {number} */
  let sum = add(5, 3);
  Logger.log("Sum: " + sum);
}

Работа с Google Workspace Services

Взаимодействие с Google Sheets: чтение и запись данных

Google Apps Script предоставляет API для взаимодействия с Google Sheets. Можно читать и записывать данные в ячейки, диапазоны и листы.

Пример:

/**
 * Пример чтения данных из Google Sheets.
 */
function readDataFromSheet() {
  /** @type {Spreadsheet} */
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  /** @type {Sheet} */
  let sheet = ss.getActiveSheet();
  /** @type {Range} */
  let range = sheet.getDataRange();
  /** @type {any[][]} */
  let values = range.getValues();
  
  Logger.log(values);
}

/**
 * Пример записи данных в Google Sheets.
 */
function writeDataToSheet() {
  /** @type {Spreadsheet} */
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  /** @type {Sheet} */
  let sheet = ss.getActiveSheet();
  
  sheet.getRange(1, 1).setValue("Hello, Sheets!");
}

Автоматизация Gmail: отправка и обработка писем

Можно отправлять электронные письма, обрабатывать входящие сообщения, создавать фильтры и правила.

Пример:

/**
 * Пример отправки электронного письма.
 */
function sendEmail() {
  /** @type {string} */
  let recipient = "example@example.com";
  /** @type {string} */
  let subject = "Test Email";
  /** @type {string} */
  let body = "This is a test email sent from Google Apps Script.";
  
  GmailApp.sendEmail(recipient, subject, body);
}

Управление Google Docs: создание и редактирование документов

Google Apps Script позволяет создавать, редактировать и форматировать документы Google Docs.

Пример:

/**
 * Пример создания нового документа Google Docs.
 */
function createDocument() {
  /** @type {Document} */
  let doc = DocumentApp.create("New Document");
  /** @type {Body} */
  let body = doc.getBody();
  body.appendParagraph("Hello, Docs!");
}

Работа с Google Calendar: создание и управление событиями

Можно создавать, изменять и удалять события в Google Calendar.

Пример:

/**
 * Пример создания события в Google Calendar.
 */
function createCalendarEvent() {
  /** @type {string} */
  let calendarId = "primary"; // ID вашего календаря
  /** @type {Date} */
  let eventStartTime = new Date();
  /** @type {Date} */
  let eventEndTime = new Date();
  eventEndTime.setHours(eventStartTime.getHours() + 1);
  
  CalendarApp.getDefaultCalendar().createEvent("Meeting", eventStartTime, eventEndTime);
}

Практические примеры использования Google Apps Script

Автоматическая отправка уведомлений по электронной почте

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

Создание пользовательских функций для Google Sheets

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

Интеграция Google Sheets с внешними API

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

Автоматизация задач управления проектами

Можно создавать скрипты, которые будут автоматически создавать задачи в Google Tasks на основе данных из Google Sheets или Google Docs.