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 Twoją domeną i podejmowanie działań w przypadku zgubienia urządzenia.
- 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
- Podmiot będący właścicielem konta Google Workspace reprezentowany przez zasób Customer.
- 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 (OU)
- Jednostka podrzędna 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
- Zdefiniowany zbiór uprawnień, które można przypisać użytkownikowi lub grupie użytkowników, reprezentowany przez zasób Role.
- Przypisanie roli
- Wpis wskazujący, któremu użytkownikowi przypisano jakie 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
Aby dowiedzieć się więcej o tworzeniu aplikacji przy użyciu interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, zapoznaj się z artykułem Pierwsze kroki jako deweloper Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację korzystającą z interfejsu Directory API, skorzystaj z tego samouczka JavaScripta.