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 realizar ações em dispositivos perdidos.
- Gerenciar seu organograma e estruturas organizacionais.
- Auditar aplicativos aos quais seus 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 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 UO é representada pelo recurso OrgUnit.
- Privilégio
- A capacidade de um usuário realizar uma ação em um recurso do Google Workspace. Afeta principalmente os 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 papéis
- Um registro que indica qual usuário recebe quais funções e sobre 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, representado pelo recurso Esquema.
- User
- 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 Primeiros passos como 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.