Descripción general de la API de Directory

La API de Directory forma parte de la API de RESTful SDK de Admin que puedes usar para crear y administrar de forma programática los 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 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, es el dominio 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 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 está representada por el 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 está representado por el recurso Privilege.
Rol
Es una colección definida de privilegios que se pueden asignar a un usuario o a un conjunto de usuarios, representada por el recurso Role.
Asignación de función
Es un registro que indica qué usuario tiene asignadas qué funciones y en qué alcance. Una asignación de función está representada por el RoleAssignment.
Esquema
Es un objeto JSON que define atributos de usuario personalizados para tu organización, representado por el recurso Schema.
Usuario
Es una cuenta de usuario individual con acceso a las aplicaciones y los recursos de Google Workspace, representada por el recurso User.

Próximos pasos