La API de Directory forma parte de la API del SDK de administrador 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. Estos son algunos casos de uso:
- Crear y administrar usuarios y agregar administradores
- Crear y administrar grupos y membresías de grupos
- Supervisar dispositivos conectados a tu dominio y realizar acciones en dispositivos perdidos
- Administrar tu organigrama y tus estructuras
- Auditar las aplicaciones a las que tus usuarios les otorgaron acceso y revocar apps no autorizadas.
A continuación, se incluye 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 (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)
- Una subunidad del árbol organizativo 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. Una UO se representa con el recurso OrgUnit.
- Privilegio
- 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, representada por el recurso Role.
- Asignación de roles
- Es un registro en el que se indica a qué usuario se le otorgan ciertos roles y en qué alcance. Una asignación de función se representa con el recurso RoleAssignment.
- Esquema
- Un objeto JSON que define atributos de usuario personalizados para tu organización, representado por el recurso Schema.
- 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 información sobre cómo desarrollar con las API 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.