Die Directory API ist Teil der RESTful Admin SDK API, mit der Sie administratorkontrollierte Ressourcen, die einem Google Workspace-Konto gehören, programmatisch erstellen und verwalten können. Hier sind einige Anwendungsfälle:
- Nutzer erstellen und verwalten und Administratoren hinzufügen.
- Gruppen und Gruppenmitgliedschaften erstellen und verwalten
- Geräte, die mit Ihrer Domain verbunden sind, im Blick behalten und Maßnahmen bei Verlust ergreifen
- Organigramm und Organisationsstrukturen verwalten
- Überprüfen Sie, welchen Anwendungen Ihre Nutzer Zugriff gewährt haben, und widerrufen Sie den Zugriff auf nicht autorisierte Apps.
Im Folgenden finden Sie eine Liste der häufig verwendeten Begriffe in der Directory API:
- Kunde
- Das Rechtssubjekt, dem das Google Workspace-Konto gehört, dargestellt durch die Customer-Ressource.
- Domain
- Falls zutreffend, die DNS-Domain, die mit einem Google Workspace-Konto verknüpft ist und durch die Domain-Ressource dargestellt wird. Nicht alle Konten haben eine zugehörige Domain.
- Organisationseinheit (OE)
- Eine Untereinheit des Organisationsbaums eines Google Workspace-Kontos, mit der Nutzer gruppiert und sortiert werden, um Richtlinien anzuwenden und Berechtigungen zu erteilen. Eine Organisationseinheit wird durch die Ressource OrgUnit dargestellt.
- Berechtigung
- Die Fähigkeit eines Nutzers, eine Aktion für eine Google Workspace-Ressource auszuführen. Gilt hauptsächlich für Administratoren. Eine Berechtigung wird durch die Ressource Privilege dargestellt.
- Rolle
- Eine definierte Sammlung von Berechtigungen, die einem Nutzer oder einer Gruppe von Nutzern zugewiesen werden kann. Sie wird durch die Role-Ressource dargestellt.
- Rollenzuweisung
- Ein Datensatz, der angibt, welchem Nutzer welche Rollen und in welchem Umfang zugewiesen werden. Eine Rollenzuweisung wird durch die Ressource RoleAssignment dargestellt.
- Schema
- Ein JSON-Objekt, das benutzerdefinierte Nutzerattribute für Ihre Organisation definiert, dargestellt durch die Schema-Ressource.
- Nutzer
- Ein einzelnes Nutzerkonto mit Zugriff auf Google Workspace-Apps und -Ressourcen, das durch die User-Ressource dargestellt wird.
Nächste Schritte
Weitere Informationen zur Entwicklung mit Google Workspace APIs, einschließlich der Verarbeitung von Authentifizierung und Autorisierung, finden Sie unter Erste Schritte als Workspace-Entwickler.
Informationen zum Konfigurieren und Ausführen einer Directory API-App finden Sie in der JavaScript-Kurzanleitung.