Visão geral da API Directory

A API Directory faz parte da API RESTful Admin SDK que pode ser usada para criar e gerenciar programaticamente recursos controlados pelo administrador de uma conta do Google Workspace. Estes são alguns exemplos de casos de uso:

  • Criar e gerenciar usuários e adicionar administradores.
  • Criar e gerenciar grupos e associações a grupos
  • Monitorar dispositivos conectados ao seu domínio e resolver problemas relacionados a dispositivos perdidos.
  • Gerenciar o organograma e as estruturas organizacionais.
  • Auditar aplicativos aos quais os usuários concederam acesso e revogar aplicativos não autorizados.

Veja a seguir uma lista de termos comuns usados na API Directory:

Cliente
A entidade proprietária da conta do Google Workspace, representada pelo recurso Cliente.
Domínio
Se aplicável, o domínio DNS associado a uma conta do Google Workspace, representado pelo recurso Domínio. Nem todas as contas têm um domínio associado.
Unidade organizacional (UO)
Uma subunidade da árvore organizacional de uma conta do Google Workspace, usada para agrupar e classificar usuários com a finalidade de aplicar políticas e conceder autorizações. Uma UO é representada pelo recurso OrgUnit.
Privilégio
A capacidade de um usuário realizar uma ação em um recurso do Google Workspace. Válido principalmente para administradores. Um privilégio é representado pelo recurso Privilégio.
Papel
Uma coleção definida de privilégios que podem ser atribuídos a um usuário ou conjunto de usuários, representado pelo recurso Papel.
Atribuição de função
Um registro que indica a qual usuário foi concedido quais papéis e em qual escopo. Uma atribuição de papel é representada pelo recurso RoleAssignment.
Esquema
Um objeto JSON que define atributos de usuário personalizados para sua organização, representados pelo recurso Esquema.
User
Uma conta de usuário final individual com acesso a apps e recursos do Google Workspace, representada pelo recurso Usuário.

Próximas etapas