Integración con Google Sheets

La integración con Google Sheets permite exportar reportes de inventario de Computtite directamente a hojas de cálculo en tu unidad de Google Drive. Esta capacidad de Modo Cloud automatiza la generación de hojas de cálculo a partir de la telemetría viva de tus activos.

Arquitectura de autenticación y autorización

Computtite se conecta a la API de Google empleando el estándar OAuth 2.0 con PKCE (Proof Key for Code Exchange) a través del navegador web predeterminado del sistema. La aplicación de escritorio nunca recibe ni almacena tu contraseña de Google:

1. Inicia la vinculación en Configuración → Integraciones (/workspace/settings/integrations).
2. Computtite inicia un socket local para loopback OAuth y abre la pantalla de consentimiento de Google en tu navegador.
3. Revisas los alcances (scopes) solicitados y autorizas el acceso.
4. Google redirige al listener local con el código de autorización temporal. Computtite lo intercambia por pares de tokens.
5. Los tokens se almacenan cifrados en el almacén de credenciales seguro del sistema operativo (e.g., macOS Keychain, Windows Credential Manager, Secret Service API).

Alcances (Scopes) requeridos

Computtite solicita permisos estrictamente delimitados a la exportación de reportes:

• https://www.googleapis.com/auth/spreadsheets: Crear, leer y modificar hojas de cálculo generadas por Computtite.
• https://www.googleapis.com/auth/drive.file: Subir y estructurar archivos creados expresamente por la aplicación. Este permiso no otorga acceso de lectura ni modificación sobre archivos preexistentes no generados por Computtite.
• https://www.googleapis.com/auth/userinfo.email: Leer la dirección de correo de la cuenta para mostrar el estado de conexión en la interfaz.

Exportar un reporte a Google Sheets

Una vez conectado, los reportes se envían desde la sección de Reportes:

1. Navega a Reportes (/workspace/reports) en la barra lateral.
2. Selecciona la definición del reporte y aplica los parámetros requeridos (rango de fechas, departamento, tipo de activo).
3. Haz clic en Exportar → Google Sheets.
4. Define el destino: crear una nueva hoja de cálculo o anexar filas a una hoja existente. Al crear una nueva, puedes especificar opcionalmente una carpeta de Drive de destino.
5. Confirma. Computtite genera la hoja, fija la fila de encabezados, dimensiona las columnas y entrega el enlace directo para su apertura.

Operaciones soportadas

• Crear nueva hoja de cálculo: Genera un libro de cálculo en Google Sheets poblado con los datos del reporte activo.
• Anexar a hoja existente: Inserta filas en una pestaña designada dentro de una hoja preexistente.
• Destino en carpeta de Drive: Permite organizar los libros generados dentro de estructuras jerárquicas en Drive.
• Selector de hojas: Consulta metadatos de hojas accesibles para facilitar la selección de destinos de anexión.

Ciclo de vida de tokens y desconexión

Los tokens de refresco se renuevan de forma transparente en segundo plano. Para desvincular la cuenta:

• Ingresa a Configuración → Integraciones (/workspace/settings/integrations) y presiona Desconectar en la tarjeta de Google. Esto purga los tokens del almacén seguro local.
• Para revocar la autorización en los servidores de Google, retira los permisos de Computtite en myaccount.google.com/permissions.