Google Forms
Управление Google Forms и ответами
Google Forms — это онлайн-инструмент Google для создания опросов и форм, который позволяет пользователям создавать формы, собирать ответы и анализировать результаты. Как часть продуктивности Google, Google Forms упрощает сбор информации, обратной связи и данных от пользователей.
Узнайте, как интегрировать инструмент Google Forms в AACFlow для автоматического чтения и обработки ответов на формы в ваших рабочих процессах. Это руководство проведет вас через подключение Google Forms, получение ответов и использование собранных данных для автоматизации. Идеально подходит для синхронизации результатов опросов, регистраций или обратной связи с вашими агентами в реальном времени.
С помощью Google Forms вы можете:
- Создавать опросы и формы: Разрабатывайте пользовательские формы для обратной связи, регистрации, викторин и многого другого
- Автоматически собирать ответы: Собирайте данные от пользователей в реальном времени
- Анализировать результаты: Просматривайте ответы в Google Forms или экспортируйте в Google Sheets для дальнейшего анализа
- Легко сотрудничать: Делитесь формами и работайте с другими над созданием и проверкой вопросов
- Интегрировать с другими сервисами Google: Подключайтесь к Google Sheets, Drive и другим сервисам
В AACFlow интеграция с Google Forms позволяет вашим агентам программно получать доступ к ответам на формы. Это открывает возможности для мощных сценариев автоматизации, таких как обработка данных опросов, запуск рабочих процессов на основе новых отправок и синхронизация результатов форм с другими инструментами. Ваши агенты могут получать все ответы для формы, извлекать конкретный ответ и использовать данные для интеллектуальной автоматизации. Подключив AACFlow к Google Forms, вы можете автоматизировать сбор данных, упростить обработку обратной связи и включить ответы на формы в возможности вашего агента.
Интегрируйте Google Forms в ваш рабочий процесс. Читайте структуру форм, получайте ответы, создавайте формы, обновляйте содержимое и управляйте уведомлениями.
Получить один ответ или список ответов из Google Form
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms |
responseId | string | Нет | ID ответа - если указан, возвращает этот конкретный ответ |
pageSize | number | Нет | Максимальное количество ответов для возврата (сервис может вернуть меньше). По умолчанию 5000. |
| Параметр | Тип | Описание |
|---|
responses | array | Массив ответов на форму (когда responseId не указан) |
↳ responseId | string | Уникальный ID ответа |
↳ createTime | string | Когда ответ был создан |
↳ lastSubmittedTime | string | Когда ответ был последний раз отправлен |
↳ answers | json | Карта ID вопросов к значениям ответов |
response | object | Один ответ на форму (когда указан responseId) |
↳ responseId | string | Уникальный ID ответа |
↳ createTime | string | Когда ответ был создан |
↳ lastSubmittedTime | string | Когда ответ был последний раз отправлен |
↳ answers | json | Карта ID вопросов к значениям ответов |
raw | json | Необработанные данные ответа API |
Получить структуру формы, включая её элементы, настройки и метаданные
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms для получения |
| Параметр | Тип | Описание |
|---|
formId | string | ID формы |
title | string | Заголовок формы, видимый респондентам |
description | string | Описание формы |
documentTitle | string | Заголовок документа, видимый в Drive |
responderUri | string | URI для совместного использования с респондентами |
linkedSheetId | string | ID связанного Google Sheet |
revisionId | string | ID ревизии формы |
items | array | Элементы формы (вопросы, разделы и т.д.) |
↳ itemId | string | ID элемента |
↳ title | string | Заголовок элемента |
↳ description | string | Описание элемента |
settings | json | Настройки формы |
publishSettings | json | Настройки публикации формы |
Создать новую Google Form с заголовком
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Заголовок формы, видимый респондентам |
documentTitle | string | Нет | Заголовок документа, видимый в Drive (по умолчанию заголовок формы) |
unpublished | boolean | Нет | Если true, создает неопубликованную форму, которая не принимает ответы |
| Параметр | Тип | Описание |
|---|
formId | string | ID созданной формы |
title | string | Заголовок формы |
documentTitle | string | Заголовок документа в Drive |
responderUri | string | URI для совместного использования с респондентами |
revisionId | string | ID ревизии формы |
Применить несколько обновлений к форме (добавить элементы, обновить информацию, изменить настройки и т.д.)
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms |
requests | json | Да | Массив запросов на обновление (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem) |
includeFormInResponse | boolean | Нет | Возвращать ли обновленную форму в ответе |
| Параметр | Тип | Описание |
|---|
replies | array | Ответы на каждый запрос обновления |
writeControl | object | Информация о контроле записи с ID ревизий |
↳ requiredRevisionId | string | Требуемый ID ревизии для обнаружения конфликтов |
↳ targetRevisionId | string | Целевой ID ревизии |
form | object | Обновленная форма (если includeFormInResponse был true) |
↳ formId | string | ID формы |
↳ info | object | Информация о форме, содержащая заголовок и описание |
↳ title | string | Заголовок формы, видимый респондентам |
↳ description | string | Описание формы |
↳ documentTitle | string | Заголовок документа, видимый в Drive |
↳ settings | object | Настройки формы |
↳ quizSettings | object | Настройки викторины |
↳ isQuiz | boolean | Является ли форма викториной |
↳ emailCollectionType | string | Тип сбора email |
↳ revisionId | string | ID ревизии формы |
↳ responderUri | string | URI для совместного использования с респондентами |
↳ linkedSheetId | string | ID связанного Google Sheet |
↳ publishSettings | object | Настройки публикации формы |
↳ publishState | object | Текущее состояние публикации |
↳ isPublished | boolean | Опубликована ли форма |
↳ isAcceptingResponses | boolean | Принимает ли форма ответы |
Обновить настройки публикации формы (опубликовать/снять с публикации, принимать ответы)
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms |
isPublished | boolean | Да | Опубликована ли форма и видна ли другим |
isAcceptingResponses | boolean | Нет | Принимает ли форма ответы (принудительно устанавливается в false, если isPublished равен false) |
| Параметр | Тип | Описание |
|---|
formId | string | ID формы |
publishSettings | json | Обновленные настройки публикации |
↳ publishState | object | Состояние публикации |
↳ isPublished | boolean | Опубликована ли форма |
↳ isAcceptingResponses | boolean | Принимает ли форма ответы |
Создать уведомление для отслеживания изменений формы (изменения схемы или новые ответы)
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms для отслеживания |
eventType | string | Да | Тип события для отслеживания: SCHEMA (изменения формы) или RESPONSES (новые отправки) |
topicName | string | Да | Имя темы Cloud Pub/Sub (формат: projects/{project}/topics/{topic}) |
watchId | string | Нет | Пользовательский ID отслеживания (4-63 символа, строчные буквы, цифры, дефисы) |
| Параметр | Тип | Описание |
|---|
id | string | ID отслеживания |
eventType | string | Тип отслеживаемого события |
topicName | string | Тема Cloud Pub/Sub |
createTime | string | Когда отслеживание было создано |
expireTime | string | Когда отслеживание истекает (через 7 дней после создания) |
state | string | Состояние отслеживания (ACTIVE, SUSPENDED) |
Получить список всех уведомлений для отслеживания формы
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms |
| Параметр | Тип | Описание |
|---|
watches | array | Список отслеживаний для формы |
↳ id | string | ID отслеживания |
↳ eventType | string | Тип события (SCHEMA или RESPONSES) |
↳ createTime | string | Когда отслеживание было создано |
↳ expireTime | string | Когда отслеживание истекает |
↳ state | string | Состояние отслеживания |
Удалить уведомление для отслеживания из формы
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms |
watchId | string | Да | ID отслеживания для удаления |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Было ли отслеживание успешно удалено |
Продлить уведомление для отслеживания еще на 7 дней
| Параметр | Тип | Обязательный | Описание |
|---|
formId | string | Да | ID формы Google Forms |
watchId | string | Да | ID отслеживания для продления |
| Параметр | Тип | Описание |
|---|
id | string | ID отслеживания |
eventType | string | Тип отслеживаемого события |
expireTime | string | Новое время истечения |
state | string | Состояние отслеживания |
