Saltearse al contenido

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 NappAIProyecto Custom (el tuyo)
Preparación en GoogleNingunaUna vez por proyecto: APIs, pantalla de consentimiento y cliente OAuth
Nombre que ve quien inicia sesiónNappAIEl de tu aplicación
Aviso «Google no ha verificado esta aplicación»Puede aparecerNo aparece si tu aplicación es interna de tu organización o está verificada
Control de las políticas de tu Google WorkspaceEl administrador puede bloquear o permitir la app de NappAILa app es tuya: el administrador la gestiona como cualquier app interna
Cuándo convienePara empezar y para la mayoría de usosCuando 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

  1. Crea la credencial del servicio y deja Select Project en NappAI.
  2. Elige el acceso, por ejemplo lectura y escritura o solo lectura.
  3. Pulsa Sign in with Google y entra con la cuenta que quieres conectar.
  4. Si Google muestra «Google no ha verificado esta aplicación», pulsa Configuración avanzada y después Ir a nappai.es.
  5. 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

  1. Ve a APIs y servicios → Credenciales → Crear credenciales → ID de cliente de OAuth.
  2. En Tipo de aplicación elige Aplicación web.
  3. 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.
  4. Pulsa Crear y copia el ID de cliente y el Secreto del cliente.

5. Crea la credencial en NappAI

  1. Crea la credencial del servicio y en Select Project elige Custom.
  2. Pega el ID de cliente en Client Id y el secreto en Client Secret.
  3. 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 NappAIAPIs que activar (proyecto Custom)Permisos según el acceso que elijasA tener en cuenta
Google GmailGmail APICompleto: gmail.modify, mail.google.com. Solo lectura: gmail.readonlySon 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 DriveGoogle Drive APICompleto: drive. Solo lectura: drive.readonlyPermisos restringidos, como Gmail.
Google SheetsGoogle Sheets API, Google Drive APICompleto: spreadsheets, drive.file, drive.readonly. Solo lectura: spreadsheets.readonly, drive.readonlyDrive se usa para listar y elegir las hojas.
Google SlidesGoogle Slides API, Google Drive APICompleto: presentations, drive.file, drive.readonly. Solo lectura: presentations.readonly, drive.readonly
Google FormsGoogle Forms API, Google Drive APICompleto: forms.body, forms.responses.readonly, drive. Solo lectura: forms.responses.readonlyEl disparador de respuestas necesita acceso a las respuestas del formulario.
Google CalendarGoogle Calendar APICompleto: calendar. Solo lectura: calendar.readonlyEl disparador de calendario funciona con cualquiera de los dos.
Google ChatGoogle 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, emailSolo 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 MeetGoogle Meet REST API, Google Calendar API, Google Drive APIcalendar, meetings.space.readonly, driveDrive se usa para las grabaciones y transcripciones.
Google AnalyticsGoogle Analytics Data API, Google Analytics Admin APIanalytics.readonly
Youtube APIYouTube Data API v3youtube, youtube.force-sslSolo 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».

  1. En la consola de Google Cloud ve a APIs y servicios → APIs y servicios habilitados → Google Chat API → Configuración.
  2. Rellena Nombre de la app (por ejemplo, el de tu empresa) y Descripción (máximo 40 caracteres). La URL del avatar es opcional.
  3. Desactiva Habilitar funciones interactivas. No hace falta un bot ni una dirección de conexión: NappAI escribe como la persona de la credencial.
  4. 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 vesPor qué pasaQué 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íasEdita 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ónLa URL de Callback de NappAI no está en el cliente OAuthAñ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ónEdita 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 proyectoActí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 configuradaSigue Google Chat: configurar la app de Chat.
«Acceso bloqueado» o «Esta app está bloqueada»La organización de Google Workspace no permite esa aplicaciónEl 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.