Как получить ответ формы Google Forms с помощью Google Apps Script?

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

Зачем использовать Google Apps Script для обработки ответов Google Forms?

Автоматизация: Автоматическая обработка ответов, исключение ручного труда.

Интеграция: Интеграция с другими сервисами Google (Sheets, Docs, Calendar и т.д.) и сторонними API.

Кастомизация: Создание пользовательских решений, адаптированных под конкретные задачи (например, сложная логика уведомлений или отчетности).

Управление данными: Улучшенный контроль и организация собранных данных.

Предварительные требования: Google Forms и Google Apps Script

Для работы с ответами Google Forms через Apps Script необходимо:

Наличие Google Form с собранными ответами.

Базовое понимание JavaScript.

Знакомство с Google Apps Script IDE.

Получение доступа к ответам Google Forms

Связывание Google Apps Script с Google Form

Самый простой способ связать скрипт с формой – открыть форму, перейти во вкладку «Инструменты» и выбрать «Редактор скриптов». Это автоматически привяжет скрипт к вашей форме.

Использование FormApp для доступа к форме

FormApp – это сервис Google Apps Script, предоставляющий доступ к формам Google. Для получения доступа к форме необходимо использовать её ID. ID можно найти в URL формы (например, https://docs.google.com/forms/d/e/<FORM_ID>/edit).

/**
 * Функция для получения формы по ID.
 * @param {string} formId ID формы Google Forms.
 * @return {GoogleAppsScript.Forms.Form|null} Объект Form или null, если форма не найдена.
 */
function getFormById(formId: string): GoogleAppsScript.Forms.Form | null {
  try {
    const form: GoogleAppsScript.Forms.Form = FormApp.openById(formId);
    return form;
  } catch (e) {
    Logger.log('Ошибка при получении формы: ' + e);
    return null;
  }
}

// Пример использования:
const formId: string = 'YOUR_FORM_ID';
const form: GoogleAppsScript.Forms.Form | null = getFormById(formId);

if (form) {
  Logger.log('Форма найдена: ' + form.getTitle());
} else {
  Logger.log('Форма не найдена.');
}

Получение последних ответов формы (getLastResponse)

Метод getLastResponse() возвращает последний ответ, отправленный в форму. Он полезен, если нужно обработать самый свежий ответ сразу после отправки. Однако, этот метод ненадежен при одновременной отправке нескольких ответов, поскольку вы не можете гарантировать порядок их поступления.

Получение всех ответов формы (getResponses)

Метод getResponses() возвращает массив всех ответов, отправленных в форму. Это предпочтительный метод для пакетной обработки ответов.

/**
 * Функция для получения всех ответов формы.
 * @param {string} formId ID формы Google Forms.
 * @return {GoogleAppsScript.Forms.FormResponse[]} Массив объектов FormResponse.
 */
function getAllFormResponses(formId: string): GoogleAppsScript.Forms.FormResponse[] {
  const form: GoogleAppsScript.Forms.Form | null = getFormById(formId);
  if (!form) {
    Logger.log('Форма не найдена.');
    return [];
  }

  const responses: GoogleAppsScript.Forms.FormResponse[] = form.getResponses();
  return responses;
}

// Пример использования:
const formId: string = 'YOUR_FORM_ID';
const responses: GoogleAppsScript.Forms.FormResponse[] = getAllFormResponses(formId);
Logger.log('Количество ответов: ' + responses.length);

Анализ и обработка данных ответа формы

Итерация по ответам формы

После получения массива ответов необходимо перебрать их для извлечения данных.

/**
 * Функция для итерации по ответам формы и логирования информации.
 * @param {string} formId ID формы Google Forms.
 */
function iterateFormResponses(formId: string): void {
  const responses: GoogleAppsScript.Forms.FormResponse[] = getAllFormResponses(formId);

  for (let i = 0; i < responses.length; i++) {
    const response: GoogleAppsScript.Forms.FormResponse = responses[i];
    Logger.log('Ответ #' + (i + 1) + ', время отправки: ' + response.getTimestamp());
  }
}

// Пример использования:
const formId: string = 'YOUR_FORM_ID';
iterateFormResponses(formId);

Получение отдельных значений ответов (getItemResponses)

Для получения значений отдельных вопросов необходимо использовать метод getItemResponses() объекта FormResponse. Этот метод возвращает массив объектов ItemResponse, каждый из которых представляет ответ на конкретный вопрос.

Работа с различными типами вопросов (текст, выбор, множественный выбор)

В зависимости от типа вопроса, способ получения значения может отличаться. Для текстовых вопросов используется getResponse(), для вопросов с выбором – также getResponse(), а для вопросов с множественным выбором – getResponse() возвращает массив выбранных вариантов.

/**
 * Функция для получения ответов на вопросы формы.
 * @param {string} formId ID формы Google Forms.
 */
function getFormItemResponses(formId: string): void {
  const responses: GoogleAppsScript.Forms.FormResponse[] = getAllFormResponses(formId);

  if (responses.length === 0) {
    Logger.log('Нет ответов в форме.');
    return;
  }

  const firstResponse: GoogleAppsScript.Forms.FormResponse = responses[0];
  const itemResponses: GoogleAppsScript.Forms.ItemResponse[] = firstResponse.getItemResponses();

  for (let i = 0; i < itemResponses.length; i++) {
    const itemResponse: GoogleAppsScript.Forms.ItemResponse = itemResponses[i];
    const question: string = itemResponse.getItem().getTitle();
    const answer: string | string[] = itemResponse.getResponse();

    Logger.log('Вопрос: ' + question + ', Ответ: ' + answer);
  }
}

// Пример использования:
const formId: string = 'YOUR_FORM_ID';
getFormItemResponses(formId);

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

Отправка уведомлений по электронной почте при получении нового ответа

Скрипт может автоматически отправлять уведомление по электронной почте при каждой отправке формы.

Запись ответов в Google Sheets

Самый распространенный пример – запись ответов в Google Sheets для дальнейшего анализа.

Создание пользовательских отчетов на основе ответов

Можно создавать отчеты в Google Docs или Slides на основе данных, собранных формой.

Распространенные проблемы и их решения

Обработка ошибок при доступе к ответам

Обязательно оборачивайте код в блоки try...catch для обработки возможных ошибок, например, если форма не найдена или доступ к ней запрещен.

Ограничения Google Apps Script и обходные пути

Google Apps Script имеет ограничения на время выполнения скрипта и количество запросов в день. Следите за этими ограничениями и оптимизируйте код, например, используйте пакетные операции.

Отладка скриптов Google Apps Script для работы с Google Forms

Используйте Logger.log() для вывода отладочной информации в консоль. Также полезно использовать встроенный отладчик Google Apps Script для пошагового выполнения кода и просмотра значений переменных.