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
Para saber mais sobre o desenvolvimento com as APIs do Google Workspace, incluindo como lidar com autenticação e autorização, consulte Começar como um desenvolvedor do Workspace.
Para saber como configurar e executar um app simples da API Directory, consulte o guia de início rápido do JavaScript.