Conectar los servicios de Google
Los servicios de Google (Gmail, Drive, Sheets, Calendar, Chat, Meet…) se conectan iniciando sesión con tu cuenta de Google desde la credencial, con el botón Sign in with Google. Al crear la credencial eliges con qué proyecto de Google Cloud se hace la conexión, en el campo Select Project:
- NappAI, la opción por defecto: usas el proyecto de Google Cloud de NappAI, que ya está preparado. No tienes que configurar nada en Google.
- Custom: usas un proyecto de Google Cloud de tu empresa. Lo preparas una vez, como explica esta página, y pegas su Client Id y su Client Secret en la credencial.
Para conectar y gestionar credenciales en general, consulta Credenciales.
Qué opción elegir
| Proyecto NappAI | Proyecto Custom (el tuyo) | |
|---|---|---|
| Preparación en Google | Ninguna | Una vez por proyecto: APIs, pantalla de consentimiento y cliente OAuth |
| Nombre que ve quien inicia sesión | NappAI | El de tu aplicación |
| Aviso «Google no ha verificado esta aplicación» | Puede aparecer | No aparece si tu aplicación es interna de tu organización o está verificada |
| Control de las políticas de tu Google Workspace | El administrador puede bloquear o permitir la app de NappAI | La app es tuya: el administrador la gestiona como cualquier app interna |
| Cuándo conviene | Para empezar y para la mayoría de usos | Cuando la política de la empresa exige apps propias, o para quitar el aviso de app no verificada |
La YouTube API solo admite proyecto Custom.
Con el proyecto de NappAI
- Crea la credencial del servicio y deja Select Project en NappAI.
- Elige el acceso, por ejemplo lectura y escritura o solo lectura.
- Pulsa Sign in with Google y entra con la cuenta que quieres conectar.
- Si Google muestra «Google no ha verificado esta aplicación», pulsa Configuración avanzada y después Ir a nappai.es.
- Marca los permisos que pide y pulsa Continuar. Vuelves a NappAI con la credencial creada.
Si una organización de Google Workspace bloquea las aplicaciones de terceros, su administrador tiene que permitir la de NappAI en la consola de administración de Google (Seguridad → Acceso y control de datos → Controles de API), o usar un proyecto Custom.
Con tu propio proyecto de Google Cloud
Lo haces una vez en la consola de Google Cloud y sirve para todas las credenciales de Google que crees con ese proyecto.
1. Elige o crea el proyecto
Arriba, en el selector de proyectos, elige el proyecto de tu empresa o crea uno nuevo, por ejemplo NappAI integraciones.
2. Activa las APIs de los servicios que vas a usar
Ve a APIs y servicios → Biblioteca, busca cada API y pulsa Habilitar. Activa solo las de los servicios que uses; la tabla de Qué necesita cada servicio dice cuáles.
3. Configura la pantalla de consentimiento
Es lo que ve la persona al pulsar Sign in with Google. Ve a APIs y servicios → Pantalla de consentimiento de OAuth (en algunas cuentas se llama Google Auth Platform) y completa:
- Nombre de la aplicación, correo de asistencia y, si quieres, el logotipo.
- Tipo de usuario o Audiencia:
- Interno: solo pueden conectarse cuentas de tu organización de Google Workspace. No hace falta que Google verifique la aplicación. Es la opción recomendada si todos los que van a conectar cuentas son de tu empresa.
- Externo: puede conectarse cualquier cuenta de Google. Mientras la aplicación esté en pruebas, solo pueden conectarse los usuarios de prueba que añadas, y el acceso caduca a los 7 días, así que habría que reconectar cada semana. Para usarla de verdad, pásala a En producción. Hasta que Google la verifique, quien se conecte verá el aviso de aplicación no verificada y hay un límite de 100 usuarios.
- Permisos (en Acceso a datos): añade los permisos de la tabla de cada servicio que vayas a usar.
4. Crea el cliente OAuth
- Ve a APIs y servicios → Credenciales → Crear credenciales → ID de cliente de OAuth.
- En Tipo de aplicación elige Aplicación web.
- En URIs de redirección autorizados añade la URL de Callback que muestra NappAI en el formulario de la credencial. Cópiala con su botón; tiene la forma
https://<tu dominio de NappAI>/external-oauth-callback. - Pulsa Crear y copia el ID de cliente y el Secreto del cliente.
5. Crea la credencial en NappAI
- Crea la credencial del servicio y en Select Project elige Custom.
- Pega el ID de cliente en Client Id y el secreto en Client Secret.
- Elige el acceso y pulsa Sign in with Google.
El mismo ID de cliente y secreto valen para todas las credenciales de Google que conectes con ese proyecto: solo tienes que tener activadas sus APIs y añadidos sus permisos.
Qué necesita cada servicio
| Credencial en NappAI | APIs que activar (proyecto Custom) | Permisos según el acceso que elijas | A tener en cuenta |
|---|---|---|---|
| Google Gmail | Gmail API | Completo: gmail.modify, mail.google.com. Solo lectura: gmail.readonly | Son permisos restringidos de Google: con una aplicación Externa en producción, Google exige además una evaluación de seguridad. Con una aplicación Interna no. |
| Google Drive | Google Drive API | Completo: drive. Solo lectura: drive.readonly | Permisos restringidos, como Gmail. |
| Google Sheets | Google Sheets API, Google Drive API | Completo: spreadsheets, drive.file, drive.readonly. Solo lectura: spreadsheets.readonly, drive.readonly | Drive se usa para listar y elegir las hojas. |
| Google Slides | Google Slides API, Google Drive API | Completo: presentations, drive.file, drive.readonly. Solo lectura: presentations.readonly, drive.readonly | |
| Google Forms | Google Forms API, Google Drive API | Completo: forms.body, forms.responses.readonly, drive. Solo lectura: forms.responses.readonly | El disparador de respuestas necesita acceso a las respuestas del formulario. |
| Google Calendar | Google Calendar API | Completo: calendar. Solo lectura: calendar.readonly | El disparador de calendario funciona con cualquiera de los dos. |
| Google Chat | Google Chat API, y configurar la app de Chat (ver abajo) | Completo: chat.spaces, chat.messages, chat.memberships, chat.spaces.create, chat.delete, openid, email. Solo lectura: chat.spaces.readonly, chat.messages.readonly, chat.memberships.readonly, openid, email | Solo funciona con cuentas de Google Workspace, no con cuentas personales de Gmail. openid y email sirven para que el disparador reconozca los mensajes de tu propia cuenta. |
| Google Meet | Google Meet REST API, Google Calendar API, Google Drive API | calendar, meetings.space.readonly, drive | Drive se usa para las grabaciones y transcripciones. |
| Google Analytics | Google Analytics Data API, Google Analytics Admin API | analytics.readonly | |
| Youtube API | YouTube Data API v3 | youtube, youtube.force-ssl | Solo con proyecto Custom. |
En la consola de Google los permisos aparecen completos, con el prefijo https://www.googleapis.com/auth/ delante; por ejemplo https://www.googleapis.com/auth/calendar. Hay tres excepciones: openid y email se escriben tal cual, y mail.google.com es https://mail.google.com/.
Google Chat: configurar la app de Chat
Google Chat pide un paso más, también en tu proyecto Custom: aunque NappAI actúa en nombre de la persona que inicia sesión, Google exige que el proyecto tenga una app de Chat configurada. Sin ella, leer funciona pero escribir falla con el error «Google Chat app not found».
- En la consola de Google Cloud ve a APIs y servicios → APIs y servicios habilitados → Google Chat API → Configuración.
- Rellena Nombre de la app (por ejemplo, el de tu empresa) y Descripción (máximo 40 caracteres). La URL del avatar es opcional.
- Desactiva Habilitar funciones interactivas. No hace falta un bot ni una dirección de conexión: NappAI escribe como la persona de la credencial.
- Pulsa Guardar.
Con el proyecto NappAI este paso ya está hecho.
Otros servicios de Google
No todos los servicios de Google usan Sign in with Google. Estos se conectan con una clave:
- Google Gemini: una clave de API de Google AI Studio.
- Google Translate: una clave de API de un proyecto de Google Cloud con la Cloud Translation API activada.
- Vertex AI API: la clave JSON de una cuenta de servicio de un proyecto con Vertex AI activado.
Problemas frecuentes
| Lo que ves | Por qué pasa | Qué hacer |
|---|---|---|
«Google refused the sign-in saved in credential… expired or been revoked» (invalid_grant) | El acceso caducó o se retiró: cambio de contraseña, permiso retirado en la cuenta de Google, o una aplicación Externa en pruebas, que caduca a los 7 días | Edita la credencial y pulsa Revalidar. Si usas un proyecto Custom en pruebas, pásalo a En producción. |
| «Error 400: redirect_uri_mismatch» al iniciar sesión | La URL de Callback de NappAI no está en el cliente OAuth | Añade la URL de Callback exacta en URIs de redirección autorizados del cliente. |
| «Request had insufficient authentication scopes» | La credencial se conectó con menos permisos de los que pide la operación | Edita la credencial, elige el acceso completo y pulsa Revalidar. Con un proyecto Custom, añade antes el permiso en la pantalla de consentimiento. |
| «… API has not been used in project … or it is disabled» | La API del servicio no está activada en tu proyecto | Actívala en APIs y servicios → Biblioteca y espera un par de minutos. |
| «Google Chat app not found» | El proyecto no tiene la app de Chat configurada | Sigue Google Chat: configurar la app de Chat. |
| «Acceso bloqueado» o «Esta app está bloqueada» | La organización de Google Workspace no permite esa aplicación | El administrador de Workspace tiene que permitirla en Controles de API, o usa una aplicación Interna de tu organización. |
Cuando NappAI añade permisos a un servicio, las credenciales que ya tenías los consiguen al Revalidarlas: edita la credencial, elige el acceso y vuelve a iniciar sesión.