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 sowie 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
- Prüfen Sie die Anwendungen, für die Ihre Nutzer Zugriff gewährt haben, und widerrufen Sie den Zugriff für nicht autorisierte Apps.
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 hauptsächlich 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, dargestellt durch die Ressource Schema.
- Nutzer
- Ein einzelnes 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.