A API Directory faz parte da API RESTful Admin SDK que pode ser usada para criar e gerenciar programaticamente recursos controlados por administrador 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
- Monitoramento de dispositivos conectados ao seu domínio e ações em caso de perda dispositivos.
- Gerenciar o organograma e as estruturas organizacionais.
- Auditar os aplicativos aos quais os usuários concederam acesso e revogá-los e apps 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 Customer.
- Domínio
- O domínio DNS associado a uma conta do Google Workspace, se aplicável representadas pelo Domain. Nem todas 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 de autorização. Uma UO é representada 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 Privilégio recurso.
- Cargo
- Uma coleção definida de privilégios que podem ser atribuídos a um usuário ou conjunto de usuários, representados pela Role.
- 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 pela RoleAssignment recurso.
- Esquema
- Um objeto JSON que define atributos de usuário personalizados para sua organização, representadas pelo Schema.
- Usuário
- Uma conta de usuário final individual com acesso aos apps do Google Workspace e recursos, representados pela User.
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 Comece a trabalhar como desenvolvedor do Workspace.
Para saber como configurar e executar um app simples da API Directory, tente Guia de início rápido do JavaScript.