Die Directory API ist Teil der RESTful Admin SDK API, mit der Sie programmgesteuert von Administratoren verwaltete Ressourcen erstellen und verwalten können, die zu einem Google Workspace-Konto gehören. Hier sind einige Anwendungsfälle:
- Nutzer erstellen und verwalten sowie Administratoren hinzufügen.
- Gruppen und Gruppenmitgliedschaften erstellen und verwalten.
- Mit Ihrer Domain verbundene Geräte überwachen und Maßnahmen bei Verlust von 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 häufig verwendeter Begriffe in der Directory API:
- Kunde
- Die Entität, die Inhaber des Google Workspace-Kontos ist, dargestellt durch die Customer-Ressource.
- Domain
- Falls zutreffend, die DNS-Domain, die mit einem Google Workspace Konto verknüpft ist, dargestellt durch die Domain Ressource. Nicht alle Konten haben eine zugeordnete Domain.
- Organisationseinheit (OE)
- Eine Untereinheit des Organisationsbaums eines Google Workspace-Kontos, mit der Nutzer gruppiert und sortiert werden, um Richtlinien anzuwenden und Autorisierungen zu gewähren. Eine OE wird durch die OrgUnit Ressource 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 Privilege Ressource dargestellt.
- Rolle
- Eine definierte Sammlung von Berechtigungen, die einem Nutzer oder einer Gruppe von Nutzern zugewiesen werden können, dargestellt durch die Role Ressource.
- Rollenzuweisung
- Ein Eintrag, der angibt, welchem Nutzer welche Rollen und in welchem Umfang gewährt werden. Eine Rollenzuweisung wird durch die RoleAssignment Ressource dargestellt.
- Schema
- Ein JSON-Objekt, das benutzerdefinierte Nutzerattribute für Ihre Organisation definiert, dargestellt durch die Schema-Ressource.
- Nutzer
- Ein einzelnes Nutzerkonto mit Zugriff auf Google Workspace-Apps und ‑Ressourcen, dargestellt durch die User Ressource.
Nächste Schritte
Informationen zur Entwicklung mit Google Workspace-APIs, einschließlich der Handhabung von Authentifizierung und Autorisierung, finden Sie unter Erste Schritte als Workspace-Entwickler.
Informationen zum Konfigurieren und Ausführen einer Directory API-App finden Sie in der JavaScript-Kurzanleitung.