A API Directory faz parte da API Admin SDK RESTful, que pode ser usada para criar e gerenciar de forma programática recursos controlados por administradores 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 tomar medidas em caso de dispositivos perdidos.
- Gerenciar sua estrutura organizacional e organograma.
- Auditar os aplicativos que os usuários concederam acesso e revogar os não autorizados.
Confira a seguir uma lista de termos comuns usados na API Directory:
- Cliente
- A entidade proprietária da conta do Google Workspace, representada pelo recurso Customer.
- Domínio
- Se aplicável, o domínio DNS associado a uma conta do Google Workspace, representado pelo recurso Domain. 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 para aplicar políticas e conceder autorizações. Uma OU é representada pelo recurso OrgUnit.
- Privilégio
- A capacidade de um usuário de realizar uma ação em um recurso do Google Workspace. Aplica-se principalmente a administradores. Um privilégio é representado pelo recurso Privilege.
- Cargo
- 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 quais usuários receberam quais funções e em qual escopo. Uma atribuição de função é representada pelo recurso RoleAssignment.
- Esquema
- Um objeto JSON que define atributos de usuário personalizados para sua organização, representado pelo recurso Esquema.
- Usuário
- Uma conta de usuário final individual com acesso aos 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 o processamento de autenticação e autorização, consulte Começar a desenvolver para o Workspace.
Para saber como configurar e executar um app simples da API Directory, consulte o Guia de início rápido do JavaScript.