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
- Surveillez les appareils connectés à votre domaine et prenez les mesures nécessaires en cas de perte d'appareil.
- Gérer votre organigramme et vos structures organisationnelles
- Auditez les applications auxquelles vos utilisateurs ont accordé l'accès et révoquez les applications non autorisées.
Vous trouverez ci-dessous une liste des termes couramment utilisés dans l'API Directory:
- Client
- Entité propriétaire du compte Google Workspace, représentée par la ressource Client.
- Domaine
- Le domaine DNS associé à un compte Google Workspace, le cas échéant, représenté par la ressource Domaine. 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 ressource OrgUnit.
- Droit
- Possibilité pour un utilisateur d'effectuer une action sur une ressource Google Workspace. S'applique principalement aux administrateurs. Un privilège est représenté par la ressource Privilege.
- Rôle
- Ensemble défini de droits d'accès 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 sont attribués les rôles et la portée de ces rôles. Une attribution de rôle est représentée par la ressource RoleAssignment.
- Schéma
- Objet JSON qui définit des attributs utilisateur personnalisés pour votre organisation, représentés par la ressource Schéma.
- Utilisateur
- Compte utilisateur final individuel ayant accès aux applications et 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 la gestion de l'authentification et de l'autorisation, consultez Premiers pas en tant que développeur Workspace.
Pour découvrir comment configurer et exécuter une application simple de l'API Directory, consultez le guide de démarrage rapide JavaScript.