Die Directory API ist Teil der RESTful Admin SDK API, mit der von Administratoren verwaltete Ressourcen, die einem Google Workspace-Konto zugewiesen sind, programmatisch erstellt und verwaltet werden können. Beispiele für 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 verlorenen Geräten ergreifen
- Organigramme und Organisationsstrukturen verwalten
- Anwendungen prüfen, denen Ihre Nutzer Zugriff gewährt haben, und nicht autorisierte Apps widerrufen
Im Folgenden finden Sie eine Liste gängiger Begriffe, die in der Directory API verwendet werden:
- Kunde
- Das Rechtssubjekt, das Inhaber des Google Workspace-Kontos ist, dargestellt durch die Ressource Kunde.
- Domain
- Die DNS-Domain, die mit einem Google Workspace-Konto verknüpft ist, dargestellt durch die Ressource Domain. Nicht allen Konten ist eine Domain zugeordnet.
- Organisationseinheit (OE)
- Eine untergeordnete Einheit des Organisationsbaums eines Google Workspace-Kontos, mit der Nutzer gruppiert und sortiert werden, um Richtlinien anzuwenden und Berechtigungen zu gewähren. Eine OE wird durch die Ressource OrgUnit dargestellt.
- Berechtigung
- Die Möglichkeit 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 Role-Ressource.
- Rollenzuweisung
- Ein Eintrag, der angibt, welchen Nutzern welche Rollen und in welchem Umfang zugewiesen sind. 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, dargestellt durch die Ressource Nutzer.
Nächste Schritte
Weitere Informationen zur Entwicklung mit Google Workspace APIs, einschließlich Authentifizierung und Autorisierung, finden Sie unter Einstieg als Workspace-Entwickler.
Informationen zum Konfigurieren und Ausführen einer einfachen Directory API-App finden Sie in der JavaScript-Kurzanleitung.