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, se muestra una lista de términos comunes que se usan en la API de Directory:
- Cliente
- La entidad propietaria de la cuenta de Google Workspace, representada por el recurso Cliente.
- Dominio
- Si corresponde, el dominio DNS asociado con una cuenta de Google Workspace, representado por el recurso Dominio No todas las cuentas tienen un dominio asociado.
- Unidad organizativa (UO)
- Es una subunidad del árbol organizacional de una cuenta de Google Workspace que se usa para agrupar y ordenar a los 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 está representado por el recurso Privilege.
- Función
- 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
- Un registro que indica a qué usuario se le otorgan qué roles y en qué alcance. 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.
- Usuario
- Una cuenta de usuario final individual con acceso a las apps y los recursos de Google Workspace, representada por el recurso User.
Próximos pasos
Para obtener 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 aprender a configurar y ejecutar una app simple de la API de Directory, prueba la guía de inicio rápido de JavaScript.