La API de Directory forma parte de la API del SDK de RESTful Admin que se puede usar para crear y administrar de manera programática recursos controlados por el administrador que pertenecen a una cuenta de Google Workspace. En algunos casos de uso se incluye lo siguiente:
- Crea y administra usuarios y agrega administradores.
- Crear y administrar grupos y membresías a grupos
- Supervisar los dispositivos conectados a tu dominio y tomar medidas en relación con los dispositivos perdidos
- Administra tu organigrama y las estructuras organizativas.
- Auditar las aplicaciones a las que los usuarios les hayan otorgado acceso y revocar aplicaciones no autorizadas
A continuación, se incluye una lista de términos comunes que se usan en la API de Directory:
- Cliente
- La entidad que es 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)
- 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. Una UO se representa con el recurso OrgUnit.
- Privilegio
- 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 a un conjunto de usuarios, representados por el recurso Role.
- Asignación de roles
- Es un registro que indica a qué usuario se le otorgan qué 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 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 información sobre cómo desarrollar 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 simple de la API de Directory, prueba la guía de inicio rápido de JavaScript.