Interfejs Directory API jest częścią interfejsu Admin SDK API w formacie REST, którego można używać do automatycznego tworzenia zasobów kontrolowanych przez administratora i zarządzania nimi. Te zasoby należą do konta Google Workspace. Przykładowe zastosowania:
- Tworzenie użytkowników i zarządzanie nimi oraz dodawanie administratorów.
- tworzenie grup i zarządzanie nimi oraz członkostwem w grupach.
- monitorowanie urządzeń połączonych z domeną i podejmowanie działań na utraconych urządzeniach;
- zarządzanie strukturą organizacyjną i organizacją.
- Sprawdzanie aplikacji, do których użytkownicy mają dostęp, i odbieranie dostępu nieautoryzowanym aplikacjom.
Oto lista typowych terminów używanych w interfejsie Directory API:
- Klient
- Jednostka będąca właścicielem konta Google Workspace reprezentowana przez zasób Klient.
- Domena
- W stosownych przypadkach domena DNS powiązana z kontem Google Workspace, reprezentowana przez zasób Domain. Nie wszystkie konta mają powiązaną domenę.
- Jednostka organizacyjna
- Podjednostka w drzewie organizacyjnym konta Google Workspace, służąca do grupowania i sortowania użytkowników na potrzeby stosowania zasad i przyznawania upoważnień. Jednostka organizacyjna jest reprezentowana przez zasób OrgUnit.
- Uprawnienie
- Możliwość wykonania przez użytkownika działania dotyczącego zasobu Google Workspace. Dotyczy to przede wszystkim administratorów. Uprawnienia są reprezentowane przez zasób Uprawnienia.
- Role
- Zdefiniowana kolekcja uprawnień, które można przypisać użytkownikowi lub grupie użytkowników, reprezentowana przez zasób Role.
- Przypisanie roli
- Rekord wskazujący, któremu użytkownikowi zostały przypisane poszczególne role i w jakim zakresie. Przypisanie roli jest reprezentowane przez zasób RoleAssignment.
- Schemat
- Obiekt JSON definiujący niestandardowe atrybuty użytkownika w organizacji, reprezentowany przez zasób Schema.
- Użytkownik
- Pojedyncze konto użytkownika z dostępem do aplikacji i zasobów Google Workspace, reprezentowane przez zasób Użytkownik.
Dalsze kroki
Więcej informacji o programowaniu z użyciem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako programista Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację korzystającą z interfejsu Directory API, skorzystaj z tego samouczka JavaScripta.