Die Directory API ist Teil der RESTful Admin SDK API, mit der sich vom Administrator gesteuerte Ressourcen eines Google Workspace-Kontos programmatisch erstellen und verwalten lassen. Einige Anwendungsfälle:
- Nutzer erstellen und verwalten und Administratoren hinzufügen
- Gruppen und Gruppenmitgliedschaften erstellen und verwalten
- Monitoring der mit Ihrer Domain verbundenen Geräte und Maßnahmen auf verloren gegangenen Geräten
- Organigramm und Organisationsstrukturen verwalten
- Anwendungen prüfen, denen Ihre Nutzer Zugriff gewährt haben, und nicht autorisierte Apps widerrufen
Im Folgenden finden Sie eine Liste häufig verwendeter Begriffe, die in der Directory API verwendet werden:
- Kunde
- Die Entität, der das Google Workspace-Konto gehört, dargestellt durch die Ressource Customer.
- Domain
- Falls zutreffend, die 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, in der Nutzer gruppiert und sortiert werden, um Richtlinien anzuwenden und Berechtigungen zu erteilen. Eine Organisationseinheit wird durch die Ressource OrgUnit repräsentiert.
- Berechtigung
- Die Fähigkeit eines Nutzers, eine Aktion für eine Google Workspace-Ressource auszuführen. Gilt in erster Linie für Administratoren. Eine Berechtigung wird durch die Ressource Berechtigung dargestellt.
- Rolle
- Eine definierte Sammlung von Berechtigungen, die einem Nutzer oder einer Gruppe von Nutzern zugewiesen werden kann, dargestellt durch die Ressource Role.
- Rollenzuweisung
- Ein Eintrag, der angibt, welchem Nutzer welche Rollen und in welchem Bereich gewährt 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, dargestellt durch die Ressource Nutzer.
Nächste Schritte
Weitere 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.