Para utilizar Google Docs en Saturn Studio, puedes optar por la integración mediante una configuración a través de Google Cloud.
Table of Contents
2. Configuración Avanzada (OAuth con Google Cloud)
Este método ofrece control completo sobre los permisos y autenticación mediante OAuth 2.0.
2.1 Crear / elegir proyecto y habilitar APIs
- Entra a Google Cloud Console y accede a tu proyecto (crea uno nuevo si hace falta).
- Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:
- Google Docs API
- Google Drive API (requerida si listarás/crearás archivos o usarás el selector de Drive).
- En cada API, haz clic en Habilitar y verifica que el estado final quede como “Habilitada”.
Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas a la API fallarán con el error access_not_configured.
2.2 Configurar Pantalla de consentimiento OAuth
Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento
Completa los datos básicos:
- Nombre de la app
- Correo de soporte
- (Opcional) Política de privacidad, Términos del servicio y dominio verificado
Luego selecciona el tipo de usuario:
Tipos de usuario para la Pantalla de consentimiento OAuth
| 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. |
Notas importantes
- Usar Google Docs o Drive suele marcar los scopes como sensibles.
- Para pasar la app a Producción (sin testers), Google puede solicitar:
- Dominio verificado
- Política de privacidad pública
- Logo de aplicación
- Verificación del equipo
Guarda los cambios.
2.3 Agregar los scopes (permisos)
- Dentro de la pantalla de consentimiento, accede a la sección Acceso a los datos.
- Haz clic en Agregar o quitar permisos.
- Utiliza la opción “Agregar permisos manualmente” y pega los siguientes scopes:
Scopes requeridos para Google Docs:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
openid
- Añade estos scopes a la tabla, haz clic en Actualizar y guardar.
2.4 Crear el Client ID y Client Secret
- Dirígete a APIs y servicios > Credenciales.
- Haz clic en “Crear credencial” > “ID de cliente de OAuth”.
- Completa los datos solicitados:
- Tipo de aplicación: Aplicación web
- Nombre de la aplicación (Saturn Studio)
- URLs de redirección ( https://studio.rocketbot.com)
- Una vez creada, Google te mostrará:
- Client ID
- Client Secret
Copia ambos.
2.5 Ingresar los datos en Saturn Studio
- Vuelve al módulo Google Docs en Saturn Studio.
- Pega el Client ID y Client Secret en los campos correspondientes del modo avanzado.