La sincronización de Google Workspace de Portail ZAPP lee el directorio de tu dominio de Google Workspace y rellena el responsable jerárquico de las cuentas, igual que las sincronizaciones de Microsoft 365 y Active Directory. Funciona en un solo sentido: de Google Workspace hacia Portail ZAPP. Nunca modifica Google Workspace.
La pantalla está reservada a los administradores. Ábrela desde Administración › Conectores y automatización › Sincronización Google Workspace (/google-directory-sync).
Preparar Google Workspace
La lectura usa la API Admin SDK Directory, con una cuenta de servicio autorizada a actuar en nombre de un administrador del dominio:
- En la consola de Google Cloud, crea una cuenta de servicio y descarga su clave JSON. Activa la API Admin SDK en el proyecto.
- En la consola de administración de Google Workspace (Seguridad › Control de acceso y de datos › Controles de API › Delegación de todo el dominio), añade el ID de cliente de la cuenta de servicio con el ámbito
https://www.googleapis.com/auth/admin.directory.user.readonly. Este ámbito solo permite leer los usuarios. - Elige un administrador del dominio que pueda leer los usuarios: la API de Google exige actuar en su nombre.
- En Portail ZAPP, guarda la clave JSON completa en un secreto del almacén.
Configurar la sincronización
- Clave de la cuenta de servicio (almacén): el secreto que contiene la clave JSON. Portail ZAPP nunca muestra la clave, solo el nombre del secreto.
- Administrador suplantado: la dirección del administrador elegido.
- Cliente de Google Workspace: deja
my_customerpara el dominio del administrador; si no, introduce el identificador del cliente (empieza porC0). - Rellenar el responsable jerárquico de las cuentas: desactivado por defecto. Mientras lo esté, la sincronización no lee nada.
Probar la conexión prueba los ajustes guardados: obtiene un token en nombre del administrador y lee una cuenta. Si falla, el mensaje te dice qué revisar: clave ilegible, delegación de todo el dominio o ámbito ausente, administrador sin permiso de lectura, Google sin respuesta.
Qué hace una sincronización
- Se leen todos los usuarios del cliente de Google, página tras página. Si la lectura falla a mitad, no se modifica nada.
- Cada usuario de Google se asocia a una cuenta de Portail ZAPP por su dirección principal: primero el identificador de inicio de sesión y luego la dirección de correo si una sola cuenta la tiene. Una dirección que tienen varias cuentas se deja de lado (contador Direcciones ambiguas).
- El responsable indicado en Google (relación Manager de la ficha del usuario) se encuentra por cualquiera de sus direcciones, principal o alias.
Las reglas son las mismas que para Microsoft 365 y Active Directory:
- un vínculo bloqueado (introducido a mano, por defecto) nunca se modifica;
- un responsable que Portail ZAPP no conoce no cambia nada;
- a un usuario sin responsable en Google solo se le cierra el vínculo si este venía de una sincronización;
- un nuevo responsable cierra el vínculo actual y abre otro: el historial se conserva en la página Responsables e historial de la cuenta, con el origen «Google Workspace».
La sincronización no crea, no modifica ni desactiva ninguna cuenta: solo trata los responsables.
Ejecutar y programar
Sincronizar ahora lanza una ejecución en el momento. La tarea programada «GoogleDirectorySync» del Planificador también se ejecuta cada noche a las 2:45; no hace nada mientras el relleno de responsables esté desactivado.
El bloque Última ejecución muestra la fecha y el resumen: cuentas de Google leídas y reconocidas, responsables actualizados, sin cambios, vínculos bloqueados que se dejan como están, responsables desconocidos, bucles evitados y direcciones ambiguas. Si la ejecución falla, muestra el motivo.