Google Docs
La conexión se realiza de la misma manera que con otras cuentas de Google en Siesta AI (OAuth 2.0).
La pantalla de inicio de sesión y consentimiento de OAuth en la cuenta de Google puede variar según el tipo de cuenta, la política de dominio y los permisos disponibles.
Resumen
Este documento describe la integración de GoogleDocs para trabajar con documentos en Google Workspace.
La integración es adecuada para:
- leer el contenido de documentos para agentes y flujos de trabajo,
- creación automatizada de documentos,
- actualización del contenido de documentos en procesos internos.
1. Conexión de Google Docs en Siesta AI
- En la sección Conexiones, haz clic en Add Connection.
- En la selección de conectores, elige la conexión de Google.
- Inicia sesión con tu cuenta de Google.
- Confirma los permisos requeridos (scopes) para Google Docs.
- En el detalle de la conexión, puedes ajustar el acceso y el alcance de las funciones permitidas (scopes/policies).
2. Integración de Google Docs
Nombre del servicio
GoogleDocs
Descripción
La integración permite crear, cargar y actualizar documentos de Google a través de una cuenta de Google autorizada.
2.1 CreateDocumentAsync
Descripción
Crea un nuevo documento de Google.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| title | String | Sí | Título del documento. |
| content | String | No | Contenido de texto inicial del documento. |
Comportamiento
- Si se proporciona
content, se escribirá en el nuevo documento creado. - La salida es el identificador y los metadatos del nuevo documento.
Uso típico
- Generación de informes
- Creación de documentos a partir de plantillas
2.2 GetDocumentAsync
Descripción
Carga un documento de Google existente según su ID.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| documentId | String | Sí | ID del documento objetivo. |
Comportamiento
- Devuelve los metadatos y el contenido del documento según los permisos de la cuenta.
- Si el documento no existe o no está disponible, la operación falla.
2.3 UpdateDocumentAsync
Descripción
Actualiza el contenido de un documento existente.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| documentId | String | Sí | ID del documento que se va a modificar. |
| content | String | Sí | Nuevo contenido destinado a ser escrito. |
Comportamiento
- La actualización se realiza sobre el documento existente.
- El alcance y la forma de los cambios se rigen por los permisos de la cuenta de Google conectada.
Uso típico
- Actualización de documentos operativos
- Adición de resultados de flujos de trabajo
- Sincronización de contenido entre sistemas
Notas de seguridad
- La integración se realiza a través de la API oficial de Google.
- El acceso se controla a través de OAuth 2.0 y los scopes otorgados por el usuario.
- Se recomienda utilizar el principio de mínimos privilegios y revisar regularmente los scopes.
Decisiones de diseño
- Todas las operaciones se realizan sobre una cuenta de Google autorizada específica.
- Los permisos sobre los documentos se heredan del uso compartido de Google Workspace.
- La falta de permisos o un documento inexistente devuelve un error de inmediato (fail-fast).
Resumen
- El conector de GoogleDocs permite crear, leer y modificar documentos en Google Docs.
- La conexión se basa en OAuth y la gestión de scopes.
- La integración es adecuada para escenarios de documentación y generación de informes automatizados en agentes y flujos de trabajo.