Die Directory API ist Teil der RESTful Admin SDK API, mit der Sie vom Administrator verwaltete Ressourcen programmatisch erstellen und verwalten können. Hier einige Anwendungsfälle:
- Nutzer erstellen und verwalten sowie Administratoren hinzufügen.
- Gruppen und Gruppenmitgliedschaften erstellen und verwalten.
- Mit Ihrer Domain verbundene Geräte überwachen und Maßnahmen auf verloren gegangenen Geräten ergreifen.
- Organisations- und Organisationsstrukturen verwalten
- Anwendungen prüfen, denen Ihre Nutzer Zugriff gewährt haben, und nicht autorisierte Anwendungen widerrufen
Die folgende Liste enthält gängige Begriffe, die in der Directory API verwendet werden:
- Kunde
- Das Rechtssubjekt, dem das Google Workspace-Konto gehört, dargestellt durch die Ressource Customer.
- Domain
- Die gegebenenfalls mit einem Google Workspace-Konto verknüpfte DNS-Domain, dargestellt durch die Ressource Domain. Nicht alle Konten sind mit einer Domain verknüpft.
- Organisationseinheit (OE)
- Eine Untereinheit der Organisationsstruktur eines Google Workspace-Kontos. Sie wird verwendet, um Nutzer zu gruppieren und zu sortieren, um Richtlinien anzuwenden und Autorisierungen zu gewähren. Eine Organisationseinheit wird durch die Ressource OrgUnit dargestellt.
- Berechtigung
- Die Möglichkeit eines Nutzers, eine Aktion für eine Google Workspace-Ressource auszuführen. Gilt hauptsächlich für Administratoren. Eine Berechtigung wird durch die Ressource Privileg dargestellt.
- Rolle
- Eine definierte Sammlung von Berechtigungen, die einem Nutzer oder einer Gruppe von Nutzern zugewiesen werden können und durch die Ressource Role dargestellt werden.
- Rollenzuweisung
- Eintrag, 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, die durch die Ressource Schema dargestellt werden.
- Nutzer
- Ein einzelnes Endnutzerkonto mit Zugriff auf Google Workspace-Anwendungen und -Ressourcen, die durch die Ressource User dargestellt werden.
Nächste Schritte
Informationen zum Entwickeln mit Google Workspace APIs, einschließlich der Authentifizierung und Autorisierung, finden Sie unter Erste Schritte als Workspace-Entwickler.
Wie Sie eine einfache Directory API-Anwendung konfigurieren und ausführen, erfahren Sie in der JavaScript-Kurzanleitung.