L'API Directory fait partie de l'API RESTful du SDK Admin. Vous pouvez l'utiliser pour créer et gérer de façon programmatique des ressources contrôlées par l'administrateur appartenant à un compte Google Workspace. Voici quelques cas d'utilisation :
- Créer et gérer des utilisateurs, et ajouter des administrateurs
- Créer et gérer des groupes et des appartenances à des groupes
- Surveiller les appareils connectés à votre domaine et prendre des mesures en cas de perte d'appareils
- Gérer votre organigramme et vos structures organisationnelles
- Auditer les applications auxquelles vos utilisateurs ont accordé l'accès et révoquer les applications non autorisées
Voici une liste des termes courants utilisés dans l'API Directory :
- Client
- Entité propriétaire du compte Google Workspace, représentée par la ressource Customer.
- Domaine
- Le cas échéant, domaine DNS associé à un compte Google Workspace account, représenté par la ressource Domain. Tous les comptes ne sont pas associés à un domaine.
- Unité organisationnelle (UO)
- Sous-unité de l'arborescence organisationnelle d'un compte Google Workspace, utilisée pour regrouper et trier les utilisateurs afin d'appliquer des règles et d'accorder des autorisations. Une UO est représentée par la OrgUnit.
- Droit
- Capacité d'un utilisateur à effectuer une action sur une ressource Google Workspace. S'applique principalement aux administrateurs. Un droit est représenté par la ressource Privilege.
- Rôle
- Ensemble défini de droits pouvant être attribués à un utilisateur ou à un ensemble d' utilisateurs, représenté par la ressource Role.
- Attribution de rôle
- Enregistrement indiquant à quel utilisateur quels rôles sont attribués et sur quel champ d'application. Une attribution de rôle est représentée par la RoleAssignment.
- Schéma
- Objet JSON qui définit des attributs utilisateur personnalisés pour votre organisation, représenté par la ressource Schema.
- Utilisateur
- Compte utilisateur individuel ayant accès aux applications et aux ressources Google Workspace, représenté par la ressource User.
Étapes suivantes
Pour en savoir plus sur le développement avec les APIs Google Workspace, y compris sur la gestion de l'authentification et des autorisations, consultez Premiers pas en tant que développeur Workspace.
Pour savoir comment configurer et exécuter une application de l'API Directory, essayez le guide de démarrage rapide JavaScript.