La API de Directory forma parte de la API del SDK de Admin de RESTful que se puede usar para lo siguiente: crear y gestionar de forma programática recursos controlados por el administrador que pertenecen a un 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 los dispositivos conectados a tu dominio y toma de medidas respecto de los dispositivos perdidos dispositivos.
- Administra tu organigrama y sus estructuras.
- Auditar aplicaciones a las que los usuarios les hayan otorgado acceso y revocarlas aplicaciones 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 representados por el Domain. Es posible que no todas 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 los usuarios con el fin de aplicar políticas y otorgar autorizaciones. La UO está representada OrgUnit.
- 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 Privilegio recurso.
- Función
- Es una colección definida de privilegios que puede asignarse a un usuario o a un conjunto de de usuarios, representados por el Recurso Role.
- Asignación de roles
- Es un registro que indica a qué usuario se le otorgaron roles y sobre qué permisos. La asignación de un rol se representa RoleAssignment recurso.
- Esquema
- Un objeto JSON que define atributos de usuario personalizados para tu organización. representados por el Recurso Schema.
- Usuario
- Una cuenta de usuario final individual con acceso a las apps de Google Workspace y recursos, representados por el User.
Próximos pasos
Para aprender sobre el desarrollo con APIs de Google Workspace, incluido el manejo autenticación y autorización, consulta Comienza 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.