Para integrar Google BigQuery con Saturn Studio, es necesario configurar una credencial de tipo OAuth 2.0 en la consola de Google Cloud. Este proceso garantiza que el robot pueda ejecutar consultas e insertar datos de forma segura bajo una autorización controlada.
Table of Contents
Crear / elegir proyecto y habilitar APIs
- Ingresa a Google Cloud Console.
- Inicia sesión con tu cuenta de Google.
- Crea un nuevo proyecto o selecciona uno existente desde la barra superior.
Habilitación de la API
Antes de configurar la credencial, el servicio debe estar activo en su proyecto:
- Acceda a la biblioteca de APIs en la consola de Google Cloud.
- Busque y haga clic en Habilitar para la BigQuery API.
Configuración de la Pantalla de consentimiento OAuth
En el menú lateral, entra a:
APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.
- Completa los campos solicitados:
- Nombre de la aplicación
- Correo de soporte
- (Opcional) Logo, dominio, enlaces de privacidad y términos.
- Elige el tipo de usuario según tu caso:
| Tipo de usuario | Descripción | Recomendación |
|---|---|---|
| Interno | Solo usuarios de tu organización (requiere dominio Google Workspace). | Úsalo si tu equipo pertenece al mismo dominio. |
| Externo | Permite acceso a cualquier cuenta de Google (modo de prueba). | Ideal para uso personal o con cuentas @gmail.com. |
🔸 Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.
Guarda los cambios al finalizar.
Configuración de Permisos (Scopes)
Durante la configuración de la pantalla de consentimiento, deberá añadir los permisos específicos que requiere el robot para operar con BigQuery:
| Permiso (URL de Scope) | Función Técnica |
.../auth/bigquery | Permiso principal para ejecutar consultas y gestionar datos. |
.../auth/userinfo.profile | Permite acceder al perfil básico del usuario. |
.../auth/userinfo.email | Requerido para ver la dirección de correo asociada. |
openid | Estándar de identidad para la autenticación OAuth. |
Creación del ID de cliente de OAuth
Con la pantalla de consentimiento configurada, proceda a generar los identificadores:
- Vaya a APIs y servicios > Credenciales.
- Seleccione Crear credenciales > ID de cliente de OAuth.
- Tipo de aplicación: Seleccione Aplicación web.
- URIs de redireccionamiento autorizados: Ingrese la dirección de su instancia de Saturn Studio (ejemplo: https://studio.rocketbot.com).
Parámetros para Saturn Studio
Al finalizar, copie los siguientes valores en el formulario de credenciales dentro de Saturn Studio:
| Parámetro | Descripción |
| Client ID | Identificador público de su proyecto en la red de Google. |
| Client Secret | Llave privada confidencial necesaria para validar la conexión. |
Privacidad del Secreto: El Client Secret solo se muestra una vez al momento de la creación. Asegúrese de guardarlo en un lugar seguro o descargar el archivo JSON inmediatamente.