La API de Directory forma parte de la API del SDK de Admin RESTful, que se puede usar para crear y administrar de forma programática recursos controlados por el administrador que pertenecen a 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 membresías de grupos
- Supervisar los dispositivos conectados a tu dominio y tomar medidas en los dispositivos perdidos
- Administrar tu organigrama y las estructuras organizativas
- Auditar las aplicaciones a las que tus 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. Una UO se representa con el recurso OrgUnit.
- Privilegio
- La capacidad de un usuario para 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 pueden 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 roles 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.
- Usuario
- Es 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
Si quieres obtener información para desarrollar con las APIs de Google Workspace, incluida la administración de la autenticación y la autorización, consulta Comienza a usar las APIs 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.