Configuración de Google Cloud Console y Credenciales OAuth2 para Gmail / Workspace

Aprende a configurar tu propio proyecto en Google Cloud Console, habilitar la API de Gmail y generar las credenciales de OAuth 2.0 necesarias para conectar tu cuenta de Google Workspace con la plataforma SAE.

📌 Resumen del Proceso

Para emitir y sincronizar correos corporativos vía Gmail API de forma segura y profesional, la plataforma SAE se comunica directamente con los servidores de Google mediante el protocolo OAuth 2.0.

El proceso consta de 4 pasos principales:

1. Crear o seleccionar un Proyecto en Google Cloud.
2. Habilitar la Gmail API.
3. Configurar la Pantalla de Consentimiento de OAuth.
4. Crear el ID de cliente de OAuth 2.0 y registrar las URLs de redirección.

🛠️ Paso 1: Crear o seleccionar un Proyecto en Google Cloud

1. Ingresa a la consola de desarrolladores de Google: console.cloud.google.com.
2. Inicia sesión con tu cuenta de administrador de Google Workspace.
3. En la barra superior, haz clic en el selector de proyectos y presiona “Proyecto Nuevo” (New Project).
4. Asigna un nombre al proyecto (por ejemplo: SAE - Integración Corporativa) y selecciona la organización de tu Google Workspace.
5. Haz clic en Crear.

[colocar imagen sobre creación de proyecto nuevo en Google Cloud Console]

🔌 Paso 2: Habilitar la Gmail API

1. En el menú lateral izquierdo de Google Cloud Console, navega a APIs y servicios > Biblioteca (APIs & Services > Library).
2. En la barra de búsqueda, escribe Gmail API.
3. Haz clic en el resultado de Gmail API y presiona el botón azul Habilitar (Enable).
4. (Opcional pero recomendado) Repite el proceso para habilitar Google Calendar API y Google Drive API si también sincronizarás agendas y documentos corporativos.

[colocar imagen sobre habilitar Gmail API en la biblioteca de APIs]

🔐 Paso 3: Configurar la Pantalla de Consentimiento OAuth

1. En el menú lateral, dirígete a APIs y servicios > Pantalla de consentimiento de OAuth (OAuth consent screen).
2. Selecciona el Tipo de Usuario (User Type):
   • Interno (Internal) (Recomendado si tienes Google Workspace): Permite que cualquier usuario con correo de tu dominio (@sumatealexito.com) se conecte sin necesidad de verificación pública de Google.
   • Externo (External): Si utilizas cuentas @gmail.com estándar o deseas conectar múltiples dominios.
3. Haz clic en Crear.
4. Completa la información básica de la aplicación:
   • Nombre de la aplicación: Súmate al Éxito - Conexión de Correo
   • Correo de soporte al usuario: Tu correo corporativo.
   • Datos de contacto del desarrollador: Tu correo corporativo.
5. Presiona Guardar y continuar.
6. En la pestaña Permisos (Scopes), haz clic en Agregar o quitar permisos y busca y selecciona los siguientes permisos de Gmail:
   • https://www.googleapis.com/auth/gmail.send (Enviar correos en tu nombre)
   • https://www.googleapis.com/auth/gmail.readonly (Lectura de mensajes)
7. Guarda y continúa hasta finalizar el asistente.

[colocar imagen sobre configuración de la pantalla de consentimiento OAuth y selección de permisos]

🔑 Paso 4: Crear Credenciales OAuth 2.0

1. En el menú lateral, ingresa a APIs y servicios > Credenciales (Credentials).
2. En la parte superior, haz clic en + Crear credenciales > ID de cliente de OAuth (OAuth client ID).
3. En Tipo de aplicación, selecciona Aplicación web (Web application).
4. Asigna un nombre identificador (por ejemplo: SAE Web Client).
5. En la sección URIs de redireccionamiento autorizados (Authorized redirect URIs), haz clic en + Agregar URI e ingresa la siguiente URL oficial de retorno:

   https://apix.sumatealexito.com/oauth/google/callback

6. Haz clic en Crear.
7. Se abrirá una ventana emergente mostrando:
   • ID de cliente (Client ID)
   • Secreto de cliente (Client Secret)
8. Copia ambos valores de forma segura.

[colocar imagen sobre creación de credenciales OAuth con la URI de redireccionamiento autorizada]

🚀 Paso 5: Conectar en la Plataforma SAE

1. Ingresa a tu panel de control de SAE y dirígete a Configuración > Canales de Comunicación o Integraciones.
2. Haz clic en Conectar Google Workspace.
3. Selecciona tu cuenta administradora de Google y concede los permisos solicitados.
4. Al finalizar la autenticación, verás el estado en verde: Google Workspace Conectado.

[colocar imagen sobre confirmación de Google Workspace Conectado en la plataforma SAE]

❓ Preguntas Frecuentes

• ¿Debo repetir este proceso para cada usuario? No. La aplicación y las credenciales en Google Cloud se crean una sola vez para toda la organización.
• ¿Qué sucede si sale una pantalla de “App no verificada”? Si configuraste la app como tipo Interno, tus usuarios corporativos no verán esta advertencia. Si la configuraste como Externo, puedes hacer clic en “Configuración avanzada > Ir a la app (no seguro)” para completar la vinculación inicial de prueba.