Google Forms es la herramienta de encuestas y formularios en línea de Google que permite a los usuarios crear formularios, recopilar respuestas y analizar resultados. Como parte del conjunto de herramientas de productividad de Google, Google Forms facilita la recopilación de información, comentarios y datos de los usuarios.
Aprende cómo integrar la herramienta Google Forms en Aptlystar para leer y procesar automáticamente las respuestas de formularios en tus flujos de trabajo. Este tutorial te guía a través de la conexión de Google Forms, la recuperación de respuestas y el uso de los datos recopilados para impulsar la automatización. Perfecto para sincronizar resultados de encuestas, registros o comentarios con tus agentes en tiempo real.
Con Google Forms, puedes:
- Crear encuestas y formularios: Diseña formularios personalizados para comentarios, registro, cuestionarios y más
- Recopilar respuestas automáticamente: Reúne datos de usuarios en tiempo real
- Analizar resultados: Visualiza respuestas en Google Forms o expórtalas a Google Sheets para un análisis más detallado
- Colaborar fácilmente: Comparte formularios y trabaja con otros para crear y revisar preguntas
- Integrar con otros servicios de Google: Conéctate con Google Sheets, Drive y más
En Aptlystar, la integración con Google Forms permite a tus agentes acceder programáticamente a las respuestas de los formularios. Esto permite potentes escenarios de automatización como procesar datos de encuestas, activar flujos de trabajo basados en nuevos envíos y sincronizar resultados de formularios con otras herramientas. Tus agentes pueden obtener todas las respuestas de un formulario, recuperar una respuesta específica y usar los datos para impulsar la automatización inteligente. Al conectar Aptlystar con Google Forms, puedes automatizar la recopilación de datos, agilizar el procesamiento de comentarios e incorporar respuestas de formularios a las capacidades de tu agente.
Integra Google Forms en tu flujo de trabajo. Proporciona un ID de formulario para listar respuestas, o especifica un ID de respuesta para obtener una sola respuesta. Requiere OAuth.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| formId | string | Sí | El ID del formulario de Google |
| responseId | string | No | Si se proporciona, devuelve esta respuesta específica |
| pageSize | number | No | Máximo de respuestas a devolver (el servicio puede devolver menos). Por defecto es 5000 |
| Parámetro | Tipo | Descripción |
|---|
data | json | Respuesta o lista de respuestas |
- Categoría:
tools
- Tipo:
google_forms
Recuperar la estructura de un formulario incluyendo sus elementos, configuración y metadatos
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms a recuperar |
| Parámetro | Tipo | Descripción |
|---|
formId | string | El ID del formulario |
title | string | El título del formulario visible para los encuestados |
description | string | La descripción del formulario |
documentTitle | string | El título del documento visible en Drive |
responderUri | string | La URI para compartir con los encuestados |
linkedSheetId | string | El ID de la hoja de cálculo de Google vinculada |
revisionId | string | El ID de revisión del formulario |
items | array | Los elementos del formulario (preguntas, secciones, etc.) |
↳ itemId | string | ID del elemento |
↳ title | string | Título del elemento |
↳ description | string | Descripción del elemento |
settings | json | Configuración del formulario |
publishSettings | json | Configuración de publicación del formulario |
Crear un nuevo formulario de Google con un título
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
title | string | Sí | El título del formulario visible para los encuestados |
documentTitle | string | No | El título del documento visible en Drive (por defecto es el título del formulario) |
unpublished | boolean | No | Si es verdadero, crea un formulario no publicado que no acepta respuestas |
| Parámetro | Tipo | Descripción |
|---|
formId | string | El ID del formulario creado |
title | string | El título del formulario |
documentTitle | string | El título del documento en Drive |
responderUri | string | La URI para compartir con los encuestados |
revisionId | string | El ID de revisión del formulario |
Aplica múltiples actualizaciones a un formulario (agregar elementos, actualizar información, cambiar configuración, etc.)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms |
requests | json | Sí | Array de solicitudes de actualización (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem) |
includeFormInResponse | boolean | No | Si se debe devolver el formulario actualizado en la respuesta |
| Parámetro | Tipo | Descripción |
|---|
replies | array | Las respuestas de cada solicitud de actualización |
writeControl | object | Información de control de escritura con IDs de revisión |
↳ requiredRevisionId | string | ID de revisión requerido para detección de conflictos |
↳ targetRevisionId | string | ID de revisión objetivo |
form | object | El formulario actualizado (si includeFormInResponse era true) |
↳ formId | string | El ID del formulario |
↳ info | object | Información del formulario que contiene título y descripción |
↳ title | string | El título del formulario visible para los encuestados |
↳ description | string | La descripción del formulario |
↳ documentTitle | string | El título del documento visible en Drive |
↳ settings | object | Configuración del formulario |
↳ quizSettings | object | Configuración de cuestionario |
↳ isQuiz | boolean | Si el formulario es un cuestionario |
↳ emailCollectionType | string | Tipo de recopilación de correo electrónico |
↳ revisionId | string | El ID de revisión del formulario |
↳ responderUri | string | La URI para compartir con los encuestados |
↳ linkedSheetId | string | El ID de la hoja de cálculo de Google vinculada |
↳ publishSettings | object | Configuración de publicación del formulario |
↳ publishState | object | Estado de publicación actual |
↳ isPublished | boolean | Si el formulario está publicado |
↳ isAcceptingResponses | boolean | Si el formulario está aceptando respuestas |
Actualiza la configuración de publicación de un formulario (publicar/despublicar, aceptar respuestas)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms |
isPublished | boolean | Sí | Si el formulario está publicado y visible para otros |
isAcceptingResponses | boolean | No | Si el formulario acepta respuestas (forzado a false si isPublished es false) |
| Parámetro | Tipo | Descripción |
|---|
formId | string | El ID del formulario |
publishSettings | json | La configuración de publicación actualizada |
↳ publishState | object | El estado de publicación |
↳ isPublished | boolean | Si el formulario está publicado |
↳ isAcceptingResponses | boolean | Si el formulario acepta respuestas |
Crea una notificación de seguimiento para cambios en el formulario (cambios de esquema o nuevas respuestas)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms a seguir |
eventType | string | Sí | Tipo de evento a seguir: SCHEMA (cambios en el formulario) o RESPONSES (nuevos envíos) |
topicName | string | Sí | El nombre del tema de Cloud Pub/Sub (formato: projects/{project}/topics/{topic}) |
watchId | string | No | ID de seguimiento personalizado (4-63 caracteres, letras minúsculas, números, guiones) |
| Parámetro | Tipo | Descripción |
|---|
id | string | El ID de la vigilancia |
eventType | string | El tipo de evento que se está vigilando |
topicName | string | El tema de Cloud Pub/Sub |
createTime | string | Cuándo se creó la vigilancia |
expireTime | string | Cuándo expira la vigilancia (7 días después de la creación) |
state | string | El estado de la vigilancia (ACTIVE, SUSPENDED) |
Listar todas las vigilancias de notificación para un formulario
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms |
| Parámetro | Tipo | Descripción |
|---|
watches | array | Lista de vigilancias para el formulario |
↳ id | string | ID de vigilancia |
↳ eventType | string | Tipo de evento (SCHEMA o RESPONSES) |
↳ createTime | string | Cuándo se creó la vigilancia |
↳ expireTime | string | Cuándo expira la vigilancia |
↳ state | string | Estado de la vigilancia |
Eliminar una vigilancia de notificación de un formulario
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms |
watchId | string | Sí | ID de vigilancia a eliminar |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Si la vigilancia se eliminó correctamente |
Renovar una vigilancia de notificaciones por 7 días más
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
formId | string | Sí | ID del formulario de Google Forms |
watchId | string | Sí | ID de vigilancia a renovar |
| Parámetro | Tipo | Descripción |
|---|
id | string | El ID de vigilancia |
eventType | string | El tipo de evento vigilado |
expireTime | string | La nueva hora de expiración |
state | string | El estado de la vigilancia |
