Configura un almacén de datos de Gmail

En esta página, se describe cómo crear un almacén de datos y conectar Gmail a Gemini Enterprise.

Antes de comenzar

  • Accede a la consola de Google Cloud con la misma cuenta que usas para la instancia de Google Workspace que planeas conectar. Vertex AI Search usa tu ID de cliente de Google Workspace para conectarse a Gmail.

  • Para aplicar el control de acceso a la fuente de datos y proteger los datos en Gemini Enterprise, asegúrate de configurar tu proveedor de identidad.

  • Antes de agregar acciones al almacén de datos de Gmail, un administrador debe completar los pasos de la sección Configura la autenticación y los permisos para Gmail para configurar la autenticación de OAuth 2.0 y proporcionarte el ID de cliente y el secreto del cliente, y configurar los permisos mínimos. Google Cloud

Crea el almacén de datos de Gmail

Para crear el almacén de datos de Gmail, sigue estos pasos:

  1. En la consola de Google Cloud Google Cloud, ve a la página de Gemini Enterprise.

    Gemini Enterprise

  2. Selecciona o crea un proyecto de Google Cloud .

  3. En el menú de navegación, haz clic en Almacenes de datos.

  4. Haz clic en + Crear almacén de datos.

  5. En Fuente, busca Gmail y haz clic en Seleccionar.

  6. En la sección Actions, haz lo siguiente:

    1. Ingresa el ID de cliente y el secreto del cliente que obtuviste de la aplicación de OAuth 2.0 y, luego, haz clic en Verificar autenticación.

      Para obtener información sobre cómo obtener el ID de cliente y el secreto del cliente, consulta Crea credenciales de cliente de OAuth. Para conocer los permisos necesarios para la búsqueda y las acciones, consulta Permisos obligatorios.

    2. Opcional: Expande Configuración avanzada y, luego, ingresa el Nombre del servicio, que es el nombre del recurso de tu servicio creado en el Directorio de servicios. Este campo es obligatorio cuando se habilitan los Controles del servicio de VPC.

    3. Elige las acciones de la lista para habilitarlas en el conector de Gmail.

    Para ver la lista de acciones, consulta Cómo ver acciones.

  7. Haz clic en Continuar.

  8. En la sección Configuración, haz lo siguiente:

    1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
    2. En el campo Nombre del conector de datos, ingresa un nombre para tu conector.
    3. Si seleccionaste US o EU como ubicación, configura los parámetros de configuración de encriptación:
      • Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
      • Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
        • En la lista Tipo de administración de claves, selecciona el tipo adecuado.
        • En la lista Clave de Cloud KMS, selecciona la clave.
      Para obtener más información, consulta Claves de encriptación administradas por el cliente.

  9. Haz clic en Continuar.

  10. En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.

  11. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

En la página Almacenes de datos, haz clic en el nombre del almacén de datos para ver el estado. Cuando el estado del almacén de datos cambia de Creando a Activo, el conector de Gmail está listo para usarse.

Después de crear el almacén de datos, crea una app y conéctala al almacén de datos de Gmail antes de ejecutar la consulta.

Ejecución de consultas

En esta sección, se describe cómo Gemini Enterprise administra tu búsqueda y las implicaciones de privacidad del uso del almacén de datos federado.

Después de autorizar Gmail y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

  • Gemini Enterprise envía tu búsqueda directamente a la API de Gmail.
  • Gemini Enterprise combina los resultados con los de otras fuentes de datos conectadas y muestra un resultado de búsqueda integral.

Mensajes de error y solución de problemas

En la siguiente tabla, se describen los mensajes de error comunes que puedes encontrar cuando trabajas con el conector de Gmail, incluidos los posibles códigos de error de HTTP y los pasos sugeridos para la solución de problemas.

Código de error Mensaje de error Descripción Soluciona problemas
403 (permiso denegado) La búsqueda con credenciales de cuentas de servicio no es compatible con los almacenes de datos de Google Workspace. El motor en el que se realiza la búsqueda tiene almacenes de datos de Google Workspace, y las credenciales que se pasan son de una cuenta de servicio. No se admite la búsqueda con credenciales de cuentas de servicio en los almacenes de datos de Google Workspace. Llama a la búsqueda con las credenciales del usuario o quita los almacenes de datos de Google Workspace del motor.
403 (permiso denegado) Las cuentas personales no son compatibles con los almacenes de datos de Google Workspace. La búsqueda se llama con una credencial de cuenta personal (@gmail.com), que no es compatible con los almacenes de datos de Google Workspace. Quita los almacenes de datos de Google Workspace del motor o usa una Cuenta de Google administrada.
403 (permiso denegado) No coincide el ID de cliente para el almacén de datos La búsqueda solo se permite para los usuarios que pertenecen a la misma organización que los almacenes de datos de Google Workspace. Quita los almacenes de datos de Google Workspace del motor o comunícate con el equipo de asistencia si el usuario y los almacenes de datos de Google Workspace deben estar en organizaciones diferentes.
403 (permiso denegado) El administrador de la organización inhabilitó el acceso de Workspace para Agent Space. Un administrador de Google Workspace inhabilitó el acceso a los datos de Google Workspace para Gemini Enterprise. Comunícate con tu administrador de Google Workspace para habilitar el acceso.

¿Qué sigue?