---
title: Google Forms
description: Lee respuestas de un formulario de Google
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_forms"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google Forms](https://forms.google.com) 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 Sim 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 Sim, 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 Sim 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.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

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.

## Herramientas

### `google_forms_get_responses`

#### Entrada

| 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 |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `data` | json | Respuesta o lista de respuestas |

## Notas

- Categoría: `tools`
- Tipo: `google_forms`

Recuperar la estructura de un formulario incluyendo sus elementos, configuración y metadatos

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ------------ | ----------- |
| `formId` | string | Sí | ID del formulario de Google Forms a recuperar |

#### Salida

| 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 |

### `google_forms_create_form`

Crear un nuevo formulario de Google con un título

#### Entrada

| 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 |

#### Salida

| 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 |

### `google_forms_batch_update`

Aplica múltiples actualizaciones a un formulario (agregar elementos, actualizar información, cambiar configuración, etc.)

#### Entrada

| 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 |

#### Salida

| 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 |

### `google_forms_set_publish_settings`

Actualiza la configuración de publicación de un formulario (publicar/despublicar, aceptar respuestas)

#### Entrada

| 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\) |

#### Salida

| 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 |

### `google_forms_create_watch`

Crea una notificación de seguimiento para cambios en el formulario (cambios de esquema o nuevas respuestas)

#### Entrada

| 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\) |

#### Salida

| 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\) |

### `google_forms_list_watches`

Listar todas las vigilancias de notificación para un formulario

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ------------ | ----------- |
| `formId` | string | Sí | ID del formulario de Google Forms |

#### Salida

| 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 |

### `google_forms_delete_watch`

Eliminar una vigilancia de notificación de un formulario

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ------------ | ----------- |
| `formId` | string | Sí | ID del formulario de Google Forms |
| `watchId` | string | Sí | ID de vigilancia a eliminar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `deleted` | boolean | Si la vigilancia se eliminó correctamente |

### `google_forms_renew_watch`

Renovar una vigilancia de notificaciones por 7 días más

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `formId` | string | Sí | ID del formulario de Google Forms |
| `watchId` | string | Sí | ID de vigilancia a renovar |

#### Salida

| 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 |
