L'API Directory fait partie de l'API RESTful Admin SDK qui permet de créer et gérer de manière automatisée des ressources contrôlées par l'administrateur appartenant à une 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 adhésions aux groupes.
- Surveiller les appareils connectés à votre domaine et intervenir en cas de perte appareils.
- Gérer votre organigramme et vos structures organisationnelles.
- Auditer les applications auxquelles vos utilisateurs ont accordé un accès et les révoquer applications non autorisées.
Voici une liste de termes courants utilisés dans l'API Directory:
- Client
- Entité propriétaire du compte Google Workspace, représentée par le Ressource Customer.
- Domaine
- Le cas échéant, le domaine DNS associé à un compte Google Workspace représentées par Ressource Domain. Il est possible que sont associés à un domaine.
- Unité organisationnelle (UO)
- Sous-unité de l'arborescence d'un compte Google Workspace, utilisée pour regrouper et trier les utilisateurs afin d'appliquer des stratégies et d'accorder des autorisations. Une UO est représentée par l'élément 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 l'icône Droit ressource.
- Rôle
- Ensemble défini de droits pouvant être attribués à un utilisateur ou à un ensemble de des utilisateurs, représentés par Ressource Role.
- Attribution de rôle
- Enregistrement indiquant les rôles attribués à chaque utilisateur et le champ d'application. Une attribution de rôle est représentée par le RoleAssignment ressource.
- Schéma
- Objet JSON qui définit des attributs utilisateur personnalisés pour votre organisation. représentées par Ressource Schema.
- Utilisateur
- Compte utilisateur final individuel ayant accès aux applications Google Workspace et ressources, représentées par Ressource User.
Étapes suivantes
Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion l'authentification et l'autorisation, reportez-vous Premiers pas en tant que développeur Workspace
Pour savoir comment configurer et exécuter une application API Directory simple, consultez la Guide de démarrage rapide avec JavaScript