L'API Directory fait partie de l'API du SDK Admin RESTful qui peut être utilisée pour créer et gérer de manière automatisée 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 adhésions à des groupes
- Surveiller les appareils connectés à votre domaine et intervenir sur les appareils perdus.
- Gestion de votre organigramme et de 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 couramment utilisés dans l'API Directory:
- Amérique du Nord
- Entité propriétaire du compte Google Workspace, représentée par la ressource Client.
- Domaine
- Le cas échéant, le domaine DNS associé à un compte Google Workspace, représenté par la ressource Domaine. Tous les comptes ne sont pas associés à un domaine.
- Unité organisationnelle (UO)
- Sous-unité de l'arborescence d'un compte Google Workspace. Elle permet de regrouper et de trier les utilisateurs afin d'appliquer des règles et d'accorder des autorisations. Une UO est représentée par la ressource OrgUnit.
- Droit
- Possibilité pour un utilisateur d'effectuer une action sur une ressource Google Workspace. S'applique principalement aux administrateurs. Un droit est représenté par la ressource Privilège.
- Rôle
- Ensemble défini de droits pouvant être attribués à un utilisateur ou à un ensemble d'utilisateurs, représenté par la ressource Rôle.
- Attribution des rôles
- Enregistrement indiquant à quel utilisateur se voit attribuer quels rôles et dans quel champ d'application. Une attribution de rôle est représentée par la ressource RoleAssignment.
- Schéma
- Objet JSON qui définit les attributs utilisateur personnalisés de votre organisation, représentés par la ressource Schéma.
- Utilisateur
- Compte utilisateur final individuel ayant accès aux applications et aux ressources Google Workspace, représenté par la ressource Utilisateur.
Étapes suivantes
Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion de l'authentification et des autorisations, consultez la page Premiers pas en tant que développeur Workspace.
Pour apprendre à configurer et exécuter une application simple de l'API Directory, consultez le guide de démarrage rapide JavaScript.