Google Sheets
La conexión se realiza de la misma manera que con otras cuentas de Google en Siesta AI (OAuth).
Resumen
Este documento describe las integraciones disponibles con los servicios de Google:
- GoogleSearch (API de Búsqueda Personalizada JSON)
- GoogleSheets (operaciones sobre hojas de cálculo)
Las integraciones están diseñadas como operaciones deterministas, sin estado, adecuadas para la automatización, informes y pipelines de datos.
1. Integración de Google Search
Nombre del servicio
GoogleSearch
Operaciones
Búsqueda
Descripción
Realiza búsquedas utilizando la API de Búsqueda Personalizada JSON de Google.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| query | String | Sí | Consulta de búsqueda enviada a la API de Google. |
Comportamiento
- Devuelve resultados según la configuración del Motor de Búsqueda Personalizado (CSE).
- Respeta los límites y cuotas de la API de Google.
- No realiza ninguna interpretación o filtrado posterior de los resultados.
Uso típico
- Análisis de mercado
- Monitoreo de marcas
- Investigación automatizada
- Enriquecimiento de datos
2. Integración de Google Sheets
Nombre del servicio
GoogleSheets
Descripción
La integración permite crear, buscar y actualizar Hojas de Cálculo de Google. Se utiliza como un ligero almacenamiento de datos o destino de exportación para procesos automatizados.
2.1 CreateSheetAsync
Descripción
Crea una nueva Hoja de Cálculo de Google con las columnas especificadas.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | String | Sí | Nombre de la Hoja de Cálculo. |
| columnNames | String | Sí | Lista de nombres de columnas separados por comas. |
Comportamiento
- Si no existe una hoja de cálculo con el nombre dado, se crea.
- Las columnas se inicializan en la primera fila.
Uso típico
- Inicialización de informes
- Preparación de la estructura de datos para la escritura posterior
2.2 GetSheetAsync
Descripción
Busca una Hoja de Cálculo de Google existente por su nombre.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | String | Sí | Nombre de la Hoja de Cálculo. |
Comportamiento
- Devuelve los metadatos de la hoja de cálculo.
- Si la hoja de cálculo no existe, la operación falla.
2.3 UpdateSheetAsync
Descripción
Reemplaza el contenido de una Hoja de Cálculo existente con datos en formato CSV.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | String | Sí | Nombre de la Hoja de Cálculo. |
| csvContent | String | Sí | Datos CSV para escribir. Si el campo contiene una coma, debe estar entre comillas. |
Comportamiento
- Reemplaza completamente el contenido existente.
- No realiza validación del tipo de dato.
- La responsabilidad por el formato CSV correcto recae en el llamador.
Uso típico
- Exportación de datos
- Sincronización de informes
- Reescritura automática de salidas de pipelines
Notas de seguridad
- La integración se realiza exclusivamente a través de la API oficial de Google.
- No se exponen credenciales de inicio de sesión directas.
- Los permisos de acceso se gestionan a nivel de cuenta de Google o cuenta de servicio.
Decisiones de diseño
- Operaciones sin estado sin caché y estado compartido.
- Nombres explícitos: la hoja de cálculo se identifica por su nombre, no por ID.
- Enfoque de fallo rápido: datos inconsistentes conducen a un error.
Resumen
- GoogleSearch proporciona búsqueda determinista a través de la API de Búsqueda Personalizada JSON de Google.
- GoogleSheets cubre la creación, búsqueda y actualización de hojas de cálculo.
- El formato de datos y los permisos son completamente responsabilidad del sistema que llama.