La integración con Google Sheets en Saturn Studio puede hacerse de dos maneras:
Table of Contents
1) Método Básico (Conexión rápida)
Pasos
- Abre el módulo Google Sheets en Saturn Studio.
- Haz clic en New para crear una nueva credencial.
- Asigna un nombre a la credencial.
- Haz clic en Conectar con Google.
- Selecciona tu cuenta y acepta los permisos solicitados.
✅ Listo: la credencial queda registrada para funciones básicas de Google Sheets.
2) Configuración Avanzada (OAuth 2.0 con Google Cloud)
Este método da mayor control de permisos y seguridad. Define manualmente los accesos que usará Saturn Studio.
2.1 Crear / elegir proyecto y habilitar APIs
- Entra a Google Cloud Console y accede a tu proyecto (crea uno si hace falta).
- Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:
- Google Sheets API
- Google Drive API (requerida si listarás/crearás archivos o usarás el selector del Drive)
- Verifica que queden con estado Habilitado.
Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas fallarán por access_not_configured.
2.2 Configurar Pantalla de consentimiento OAuth
Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.
Completa:
- Nombre de la aplicación
- Correo de soporte
- (Opcional) Política de privacidad, Términos y dominio (recomendado para publicación/producción)
Público (tipo de usuario)
Elige uno y actúa según corresponda:
| Opción | ¿Quién puede usar la app? | Qué debes hacer |
|---|---|---|
| Interno | Solo usuarios de tu organización (dominio de Google Workspace). No funciona con cuentas @gmail.com personales. | No necesitas agregar testers. Cualquier usuario del dominio puede autorizar. Úsalo si todo tu equipo pertenece al mismo dominio. |
| Usuarios externos | Cualquier usuario con Cuenta de Google, pero la app inicia en modo de prueba. | Debes agregar manualmente a los usuarios de prueba (incluyéndote) para poder autorizar. Sólo esos usuarios podrán iniciar sesión mientras la app esté en prueba. Para abrirla a más usuarios/publicar, debes enviar a verificación si usas scopes sensibles/restringidos. |
Nota: Usar Drive y Sheets suele marcar scopes como sensibles. Para pasar a Producción (sin lista de testers) es probable que Google solicite verificación de la app (dominio verificado, logo, política de privacidad, etc.).
Guarda los cambios.
2.3 Agregar scopes (permisos) a la app
Ruta: Pantalla de consentimiento OAuth → Acceso a los datos → Agregar o quitar permisos.
Agrega manualmente los scopes que necesites (principio de menor privilegio):
Scopes recomendados para Google Sheets
https://www.googleapis.com/auth/spreadsheets(leer/escribir en hojas)https://www.googleapis.com/auth/spreadsheets.readonly(solo lectura)https://www.googleapis.com/auth/drive(acceso a archivos de Drive: listar/crear/mover, etc., úsalo solo si lo necesitas)https://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/userinfo.profileopenid
Actualiza y guarda.
2.4 Crear Client ID y Client Secret
Ruta: APIs y servicios → Credenciales → Crear credencial → ID de cliente de OAuth.
Completa:
- Tipo de aplicación: Aplicación web
- Nombre: por ejemplo,
Saturn Studio - URIs de redirección:
https://studio.rocketbot.com/
Al guardar, Google genera:
- Client ID
- Client Secret
Cópialos y resérvalos.
2.5 Cargar credenciales en Saturn Studio
- Regresa al módulo Google Sheets en Saturn Studio.
- En el modo Avanzado (OAuth), pega el Client ID y Client Secret en los campos correspondientes.
- Guarda la credencial y realiza la conexión.
Notas importantes
- Usuarios externos (modo de prueba): agrega tu correo y los de tu equipo en Usuarios de prueba. Si no están en la lista, verán error al autorizar.
- Interno: solo disponible con Google Workspace. Si usas cuenta personal @gmail.com, deberás elegir Usuarios externos.
- Scopes y APIs: los scopes permiten solicitar permisos; habilitar la API permite realmente usarla. Necesitas ambos.
- URIs de redirección: deben coincidir exactamente con lo configurado en Google Cloud.
- Verificación: para publicar la app a producción (externa) y usar scopes sensibles/restringidos, Google puede requerir verificación (política de privacidad pública, dominio verificado, branding, etc.).