Die Directory API ist Teil der RESTful Admin SDK API, mit der Sie programmatisch vom Administrator gesteuerte Ressourcen eines Google Workspace-Kontos erstellen und verwalten können. Hier einige Anwendungsfälle:
- Nutzer erstellen und verwalten sowie Administratoren hinzufügen
- Gruppen und Gruppenmitgliedschaften erstellen und verwalten
- Monitoring von mit Ihrer Domain verbundenen Geräten und Ergreifen von Maßnahmen bei verlorenen Geräten
- Organisationsdiagramm und Organisationsstrukturen verwalten
- Anwendungen prüfen, denen Ihre Nutzer Zugriff gewährt haben, und nicht autorisierte Anwendungen widerrufen.
Im Folgenden finden Sie eine Liste gebräuchlicher Begriffe, die in der Directory API verwendet werden:
- Kunde
- Die Entität, die Inhaber des Google Workspace-Kontos ist, dargestellt durch die Ressource Customer.
- Domain
- Falls zutreffend, die mit einem Google Workspace-Konto verknüpfte DNS-Domain, die durch die Ressource Domain dargestellt wird. Nicht allen Konten ist eine Domain zugeordnet.
- 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 OE wird durch die Ressource OrgUnit dargestellt.
- Berechtigung
- Die Fähigkeit eines Nutzers, eine Aktion für eine Google Workspace-Ressource auszuführen. Gilt vor allem für Administratoren. Berechtigungen werden durch die Berechtigungsressource dargestellt.
- Rolle
- Eine definierte Sammlung von Berechtigungen, die einem Nutzer oder einer Gruppe von Nutzern zugewiesen werden kann, dargestellt durch die Ressource Rolle.
- Rollenzuweisung
- Ein Eintrag, der angibt, welchem Nutzer welche Rollen in welchem Umfang gewährt werden. Rollenzuweisungen werden durch die Ressource RoleAssignment dargestellt.
- Schema
- Ein JSON-Objekt, das benutzerdefinierte Nutzerattribute für Ihre Organisation definiert, die von der Ressource Schema dargestellt werden.
- Nutzer
- Ein individuelles Endnutzerkonto mit Zugriff auf Google Workspace-Anwendungen und -Ressourcen, das durch die Ressource Nutzer dargestellt wird.
Nächste Schritte
Weitere Informationen zur Entwicklung mit Google Workspace APIs, einschließlich der Authentifizierung und Autorisierung, finden Sie unter Erste Schritte als Workspace-Entwickler.
Informationen zum Konfigurieren und Ausführen einer einfachen Directory API-Anwendung finden Sie in der JavaScript-Kurzanleitung.