Productividad
Google Docs en tu producto y en tus agentes de IA, con una API
El toolkit de Google Docs cubre tres operaciones sobre los documentos de una cuenta Google: crear un documento en blanco, leer su título y contenido, y aplicar ediciones a su texto, incluido reemplazar marcadores para completar una plantilla. Con Connect, tu producto o agente de IA las llama por un solo endpoint, mientras Connect guarda y renueva las credenciales OAuth y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_docs_create_document/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"title": "<title>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Docs.
- 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 Docs. 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 Docs.
Generar documentos desde datos
Crea un Doc por cada propuesta o informe que genera tu producto e inserta el texto con Update document en el Drive del cliente.
Completar plantillas
Usa replaceAllText para cambiar marcadores, como el nombre de un cliente o una fecha, en un documento, sin calcular posiciones.
Agente que lee y edita
Un agente de IA lee un documento con Get document, entiende su texto y aplica un lote de ediciones que se aplica completo o falla completo.
Tools
3 tools de Google Docs
- Crear documentoPOSTCrea un Google Doc en blanco en la carpeta raíz de Mi unidad y lo devuelve con su documentId. Agrega el contenido después con Update document. Para partir de una plantilla o de una carpeta concreta, copia o crea el archivo con Google Drive.
- Obtener documentoGETObtiene un documento con título, revisionId y contenido. El texto está en body.content: cada párrafo tiene elements cuyo textRun.content guarda el texto, con startIndex y endIndex que Update document usa como posiciones, contadas en unidades de código UTF-16.
- Actualizar documentoPOSTAplica una lista de ediciones a un documento, en orden y todo o nada: si una solicitud es inválida, no se aplica ninguna. Cada elemento de requests tiene exactamente un tipo de edición. replaceAllText completa una plantilla sin posiciones; los demás tipos usan los índices de Get document. Envía las ediciones con índices del mayor al menor, para que una no desplace a la siguiente.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_docs, 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 Docs
¿Necesito implementar la API de Google Docs?
No. Connect ya trae 3 tools de Google Docs 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 Docs?
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
Figma12 tools
Google Forms6 tools
Google Tasks9 tools
Miro12 tools
Notion13 tools
Superhuman Docs12 tools
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
