Die Directory API ist Teil der RESTful Admin SDK API, mit der Sie von Administratoren gesteuerte Ressourcen, die einem Google Workspace-Konto gehören, programmatisch erstellen und verwalten können. Einige Anwendungsfälle:
- Nutzer erstellen und verwalten sowie Administratoren hinzufügen
- Gruppen und Gruppenmitgliedschaften erstellen und verwalten
- Geräte überwachen, die mit Ihrer Domain verbunden sind, und Maßnahmen bei verlorenen Geräten ergreifen
- Organigramm und Organisationsstrukturen verwalten
- Anwendungen prüfen, denen Ihre Nutzer Zugriff gewährt haben, und nicht autorisierte Anwendungen 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, die durch die Ressource Domain repräsentiert wird. Nicht allen Konten ist eine Domain zugeordnet.
- Organisationseinheit (OE)
- Eine Untereinheit der Organisationsstruktur eines Google Workspace-Kontos. Sie wird zum Gruppieren und Sortieren von Nutzern verwendet, um Richtlinien anzuwenden und Autorisierungen zu erteilen. 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. Eine Berechtigung wird durch die Berechtigungsressource dargestellt.
- Rolle
- Eine definierte Sammlung von Berechtigungen, die einem oder mehreren Nutzern zugewiesen werden können, dargestellt durch die Ressource Rolle.
- Rollenzuweisung
- Ein Eintrag, der angibt, welchem Nutzer welche Rollen 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 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.
In der JavaScript-Kurzanleitung erfahren Sie, wie Sie eine einfache Directory API-Anwendung konfigurieren und ausführen.