La API de Directory forma parte de la API de SDK de administrador de RESTful que se puede usar para crear y administrar de manera programática recursos administrados por el administrador que pertenezcan a una cuenta de Google Workspace. Estos son algunos casos prácticos:
- Crear y administrar usuarios y agregar administradores.
- Crear y administrar grupos y membresías de grupos
- Dispositivos de supervisión conectados a tu dominio y acción en dispositivos perdidos
- Administrar el organigrama y las estructuras organizativas
- Auditar las aplicaciones a las que tus usuarios les hayan otorgado acceso y revocado apps no autorizadas
A continuación, se muestra una lista de términos comunes que se usan en la API de Directory:
- Cliente
- Es la entidad que posee la cuenta de Google Workspace, representada por el recurso Cliente.
- Dominio
- Si corresponde, el dominio de DNS asociado a 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
- La capacidad de un usuario de realizar una acción en un recurso de Google Workspace. Se aplica principalmente a los administradores. Un recurso se representa con el recurso Privilegio.
- Role
- Una colección definida de privilegios que se pueden asignar a un usuario o conjunto de usuarios, representado por el recurso Función.
- Asignación de funciones
- Un registro que indica qué usuario tiene ciertas funciones y en qué alcance. El recurso RoleAssignment representa una asignación de función.
- Esquema
- Un objeto JSON que define atributos de usuario personalizados para tu organización, representados por el recurso de esquema.
- User
- 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
Para obtener información sobre el desarrollo 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 de la API de Directory simple, consulta la guía de inicio rápido de JavaScript.