Productividad
Google Forms en tu producto y en tus agentes de IA, con una API
El toolkit de Google Forms crea formularios, lee su estructura, edita preguntas, secciones y ajustes, publica o cierra un formulario para respuestas y lee las respuestas. Con Connect, un producto o agente de IA arma y recoge datos de encuestas en la cuenta del cliente sin construir la integración con Google.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_forms_create_form/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"info": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Forms.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Google Forms. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Google Forms.
Encuestas creadas desde tu producto
Crea un formulario, agrega sus preguntas con una sola actualización, publícalo y envía el responderUri a la audiencia del cliente.
Respuestas directo al CRM
Lista las respuestas de un formulario y usa los questionIds del formulario para asignar cada respuesta a un campo de tu CRM o base de datos.
Agentes que gestionan formularios
Deja que un agente de IA abra un formulario para respuestas, lea las respuestas después y cierre el formulario cuando termine el período de recogida.
Tools
6 tools de Google Forms
- Crear formularioPOSTCrea un formulario vacío con un título y devuelve su formId y responderUri, el enlace para quienes responden. Agrega las preguntas con Update form. Desde julio de 2026, un formulario creado por la API empieza sin publicar y no recibe respuestas hasta que Update publish settings lo publique.
- Obtener formularioGETDevuelve un formulario: info, settings, publishSettings, responderUri (el enlace para quienes responden), revisionId y los elementos en orden, cada uno con su itemId y, en una pregunta, su questionId. Las respuestas de List responses se indexan por questionId.
- Actualizar formularioPOSTEdita un formulario: crea, cambia, mueve y elimina preguntas, bloques de texto y secciones, y cambia el título, la descripción y la recogida de correo. Las ediciones se aplican en orden y valen todas o ninguna. Las respuestas de createItem traen el nuevo itemId y questionId.
- Actualizar ajustes de publicaciónPOSTPublica, cierra o despublica un formulario. isPublished e isAcceptingResponses ambos true lo abren a respuestas, isPublished true con isAcceptingResponses false lo cierra, y ambos false lo despublican. Quién puede responder sigue el uso compartido del formulario en Google Drive. Los formularios heredados, cuyo Get form no tiene publishSettings, no están soportados.
- Listar respuestasGETLista las respuestas de un formulario, cada una con responseId, createTime, lastSubmittedTime, respondentEmail cuando el formulario lo recoge y answers indexadas por questionId: Get form indica qué pregunta es cada questionId. Pasa nextPageToken como pageToken para leer la página siguiente.
- Obtener respuestaGETDevuelve una respuesta de un formulario, con las respuestas indexadas por questionId.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_forms, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Google Forms
¿Necesito implementar la API de Google Forms?
No. Connect ya trae 6 tools de Google Forms descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Google Forms?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
