La API de Directory forma parte de la API del SDK de Admin basada en REST que se puede usar para crear y administrar de forma programática los 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 membresías de grupos
- Supervisar los dispositivos conectados a tu dominio y tomar medidas en relación con los dispositivos perdidos
- Administrar tu organigrama y las estructuras organizativas
- Auditar las aplicaciones a las que tus usuarios otorgaron acceso y revocar las aplicaciones no autorizadas
A continuación, se incluye una lista de términos comunes que se usan en la API de Directory:
- Cliente
- Es la entidad propietaria de la cuenta de Google Workspace, representada por el recurso Customer.
- Dominio
- Si corresponde, el dominio de DNS asociado con una cuenta de Google Workspace, representado por el recurso Domain. 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 OU se representa con el recurso OrgUnit.
- Privilegio
- Es la capacidad de un usuario para realizar una acción en un recurso de Google Workspace. Se aplica principalmente a los administradores. Un privilegio se representa con el recurso Privilege.
- Función
- Colección definida de privilegios que se pueden asignar a un usuario o conjunto de usuarios, representada 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 rol se representa con el recurso RoleAssignment.
- Esquema
- Objeto JSON que define atributos del usuario personalizados para tu organización, representados por el recurso Schema.
- Usuario
- 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 Comienza a desarrollar con 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.