La API de Directory forma parte de la API del SDK de Admin de RESTful que se puede usar para crear y administrar de manera programática recursos controlados por el administrador que son propiedad de una cuenta de Google Workspace. En algunos casos de uso se incluye lo siguiente:
- Crear y administrar usuarios, y agregar administradores
- Crear y administrar grupos y pertenencia a grupos
- Supervisión de dispositivos conectados a tu dominio y toma de medidas en dispositivos perdidos.
- Administra tu organigrama y sus estructuras.
- Auditar las aplicaciones a las que los usuarios les otorgaron acceso y revocar las apps no autorizadas
A continuación, encontrarás una lista de términos comunes usados en la API de Directory:
- Cliente
- La entidad propietaria de la cuenta de Google Workspace, representada por el recurso Customer.
- Dominio
- Si corresponde, el dominio DNS asociado a una cuenta de Google Workspace, representado por el recurso Domain. No todas las cuentas tienen un dominio asociado.
- Unidad organizativa (UO)
- Una subunidad del árbol organizativo de una cuenta de Google Workspace, que se usa para agrupar y ordenar usuarios con el fin de aplicar políticas y otorgar autorizaciones. El recurso OrgUnit representa una UO.
- Privilegio
- Es la capacidad de un usuario de realizar una acción en un recurso de Google Workspace. Se aplica principalmente a los administradores. Un privilegio se representa con el recurso Privilegio.
- Rol
- Es una colección definida de privilegios que se puede asignar a un usuario o conjunto de usuarios, representado por el recurso Role.
- Asignación de roles
- Es un registro que indica a qué usuario se le otorgaron roles y sobre qué permisos. El recurso RoleAssignment representa una asignación de función.
- Esquema
- Un objeto JSON que define atributos de usuario personalizados para tu organización, representados por el recurso Esquema.
- User
- Una cuenta de usuario final individual con acceso a las apps y los recursos de Google Workspace, representada por el recurso Usuario.
Próximos pasos
Para obtener más información sobre el desarrollo con las APIs de Google Workspace, incluido el manejo de la autenticación y la autorización, consulta Primeros pasos como desarrollador de Workspace.
Para obtener información sobre cómo configurar y ejecutar una app de la API de Directory simple, prueba la guía de inicio rápido de JavaScript.