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

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

Обзор Forms API: создание и управление формами

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

Необходимые условия для работы с Apps Script и формами

Для работы с Google Apps Script и Forms API необходим аккаунт Google. Вам также потребуется базовое понимание JavaScript и принципов работы с API. Рекомендуется иметь опыт работы с Google Forms для лучшего понимания структуры и возможностей форм.

Создание новой формы с помощью Google Apps Script

Использование FormApp.create(title) для создания формы

Метод FormApp.create(title) является отправной точкой для создания новой формы. Он создает пустую форму с указанным названием. Этот метод возвращает объект Form, который представляет собой созданную форму.

Настройка названия и описания формы

После создания формы, вы можете настроить ее название и описание, используя методы setTitle(title) и setDescription(description) соответственно. Название формы отображается в верхней части формы, а описание предоставляет дополнительную информацию для пользователей.

Пример кода: создание простой формы с названием

/**
 * Создает новую Google Form с указанным названием.
 *
 * @param {string} formTitle Название создаваемой формы.
 * @return {GoogleAppsScript.Forms.Form} Созданная форма.
 */
function createNewForm(formTitle: string): GoogleAppsScript.Forms.Form {
  // Создаем новую форму.
  const form: GoogleAppsScript.Forms.Form = FormApp.create(formTitle);

  // Устанавливаем описание формы.
  form.setDescription('Это форма, созданная с помощью Apps Script.');

  // Возвращаем созданную форму.
  return form;
}

// Пример использования
function testCreateForm() {
  const myForm: GoogleAppsScript.Forms.Form = createNewForm('Форма для сбора данных о рекламе');
  Logger.log('Форма создана: ' + myForm.getTitle() + ' - ' + myForm.getEditUrl());
}

Добавление элементов в форму

Типы элементов формы: текст, текст абзаца, множественный выбор, флажки и т.д.

Forms API поддерживает различные типы элементов формы, включая:

Текст (TEXT): для коротких текстовых ответов.

Текст абзаца (PARAGRAPH_TEXT): для длинных текстовых ответов.

Множественный выбор (MULTIPLE_CHOICE): выбор одного варианта из списка.

Флажки (CHECKBOX): выбор нескольких вариантов из списка.

Раскрывающийся список (LIST): выбор одного варианта из раскрывающегося списка.

Шкала (SCALE): выбор значения на шкале.

Сетка с множественным выбором (GRID): матрица с вариантами множественного выбора.

Сетка с флажками (CHECKBOX_GRID): матрица с флажками.

Дата (DATE): выбор даты.

Время (TIME): выбор времени.

Методы добавления элементов: addTextItem, addCheckboxItem и другие

Для добавления элементов в форму используются методы, соответствующие типу элемента:

addTextItem(question): добавляет элемент для ввода текста.

addParagraphTextItem(question): добавляет элемент для ввода текста абзаца.

addMultipleChoiceItem(question): добавляет элемент с множественным выбором.

addCheckboxItem(question): добавляет элемент с флажками.

addListItem(question): добавляет элемент с раскрывающимся списком.

addScaleItem(question): добавляет элемент со шкалой.

addGridItem(question): добавляет элемент — сетку с множественным выбором.

addCheckboxGridItem(question): добавляет элемент — сетку с флажками.

addDateItem(question): добавляет элемент для ввода даты.

addTimeItem(question): добавляет элемент для ввода времени.

Настройка параметров элементов: обязательность, подсказки, варианты ответов

Для каждого элемента можно настроить различные параметры, такие как обязательность ответа (setRequired(boolean)), подсказки (setHelpText(text)) и варианты ответов (например, для элементов множественного выбора и флажков). Настройка параметров позволяет создавать более удобные и информативные формы.

Примеры кода: добавление различных типов элементов в форму

/**
 * Добавляет различные типы элементов в форму.
 *
 * @param {GoogleAppsScript.Forms.Form} form Объект формы, в которую добавляются элементы.
 */
function addFormItems(form: GoogleAppsScript.Forms.Form) {
  // Добавляем текстовый вопрос.
  const textItem: GoogleAppsScript.Forms.TextItem = form.addTextItem('Введите ваш email-адрес');
  textItem.setRequired(true);
  textItem.setHelpText('Пример: example@example.com');

  // Добавляем вопрос с множественным выбором.
  const multipleChoiceItem: GoogleAppsScript.Forms.MultipleChoiceItem = form.addMultipleChoiceItem('Какой рекламный канал наиболее эффективен для вас?');
  multipleChoiceItem.setChoices([
    form.createChoice('Google Ads'),
    form.createChoice('Яндекс.Директ'),
    form.createChoice('Социальные сети'),
    form.createChoice('Email-маркетинг')
  ]);

  // Добавляем вопрос с флажками.
  const checkboxItem: GoogleAppsScript.Forms.CheckboxItem = form.addCheckboxItem('Какие инструменты аналитики вы используете?');
  checkboxItem.setChoices([
    form.createChoice('Google Analytics'),
    form.createChoice('Яндекс.Метрика'),
    form.createChoice('Mixpanel'),
    form.createChoice('Другие')
  ]);

  // Добавляем вопрос с текстом абзаца.
  const paragraphTextItem: GoogleAppsScript.Forms.ParagraphTextItem = form.addParagraphTextItem('Оставьте ваш отзыв о нашей рекламной кампании');
  paragraphTextItem.setRequired(false);
}

// Пример использования
function testAddItems() {
  const form: GoogleAppsScript.Forms.Form = FormApp.openById('YOUR_FORM_ID'); // Замените YOUR_FORM_ID на ID вашей формы.
  addFormItems(form);
  Logger.log('Элементы добавлены в форму: ' + form.getTitle());
}

Настройка и управление формой

Открытие и закрытие формы для приема ответов

Метод setAcceptingResponses(boolean) позволяет открыть или закрыть форму для приема ответов. Если форма закрыта, пользователи не смогут отправлять ответы.

Получение URL-адреса формы для распространения

Метод getPublishedUrl() возвращает URL-адрес формы, который можно использовать для распространения формы среди пользователей.

Настройка параметров отправки: уведомления, подтверждения

Google Forms позволяет настроить параметры отправки, такие как отправка уведомлений об ответах и отображение подтверждающего сообщения после отправки формы. К сожалению, Forms API напрямую не предоставляет методы для изменения этих параметров (например, отправка уведомлений). Однако, можно реализовать кастомные решения через триггеры (onFormSubmit) и сервисы отправки email.

Управление ответами: сохранение в Google Sheets

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

Практический пример: создание формы для сбора отзывов

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

Создайте новый проект Google Apps Script.

Напишите функцию для создания новой формы с названием "Форма для сбора отзывов".

Добавьте следующие элементы в форму:

Текстовый вопрос: "Ваше имя"

Вопрос с множественным выбором: "Насколько вы удовлетворены нашим продуктом?" (Варианты: Очень доволен, Доволен, Нейтрально, Недоволен, Очень недоволен)

Вопрос с текстом абзаца: "Ваши предложения по улучшению продукта"

Сделайте вопрос "Ваше имя" обязательным.

Получите URL-адрес созданной формы и распространите ее среди пользователей.

Настройка формы для сбора конкретной информации

Для сбора конкретной информации необходимо тщательно продумать структуру вопросов и типы элементов формы. Используйте подсказки и валидацию данных для обеспечения качества ответов. Например, для сбора email-адресов можно использовать регулярные выражения для проверки формата.

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

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

/**
 * Функция, срабатывающая при отправке формы.
 *
 * @param {GoogleAppsScript.Events.FormsOnFormSubmit} e Объект события отправки формы.
 */
function onFormSubmit(e: GoogleAppsScript.Events.FormsOnFormSubmit) {
  // Получаем данные ответа.
  const responses: any = e.response.getItemResponses();

  // Получаем email адрес респондента, если он запрошен в форме
  let emailAddress: string = "";
  for (let i = 0; i < responses.length; i++) {
    if (responses[i].getItem().getTitle() === 'Ваше имя') { // Замените 'Ваше имя' на фактическое название вопроса про имя/email
      emailAddress = responses[i].getResponse();
      break;
    }
  }
  // Отправляем уведомление.
  MailApp.sendEmail({
    to: 'your_email@example.com', // Замените на ваш email
    subject: 'Новый ответ в форме!',
    body: 'Пользователь ' + emailAddress + ' оставил новый отзыв.',
    htmlBody: '
Новый ответ в форме!
Пользователь ' + emailAddress + ' оставил новый отзыв.
'
  });
}

Заключение: возможности и преимущества использования Google Apps Script для создания форм

Google Apps Script предоставляет мощные инструменты для автоматизации создания и управления Google Forms. Вы можете создавать собственные решения для сбора данных, проведения опросов и автоматической обработки ответов. Использование Apps Script позволяет значительно расширить возможности Google Forms и адаптировать их под свои конкретные нужды. Интеграция с другими сервисами Google, такими как Sheets и Gmail, делает Apps Script незаменимым инструментом для автоматизации рабочих процессов.