Interfejs Directory API jest częścią interfejsu API RESTowego pakietu Admin SDK, który umożliwia automatyczne tworzenie zasobów kontrolowanych przez administratora należących do konta Google Workspace oraz zarządzanie nimi. Przykładowe zastosowania:
- Tworzenie użytkowników i zarządzanie nimi oraz dodawanie administratorów.
- Tworzenie grup i członkostwa w grupach oraz zarządzanie nimi.
- monitorowanie urządzeń połączonych z domeną i wykonywanie działań na utraconych urządzeniach;
- Zarządzanie schematem organizacyjnym i strukturami organizacji.
- Kontrola aplikacji, którym użytkownicy przyznali dostęp, a także unieważnianie nieautoryzowanych aplikacji.
Poniżej znajdziesz listę typowych pojęć używanych w interfejsie Directory API:
- Klient
- Podmiot będący właścicielem konta Google Workspace reprezentowany przez zasób Klient.
- Domena
- Domena DNS powiązana z kontem Google Workspace (w odpowiednich przypadkach) reprezentowana przez zasób Domena. Nie z każdym kontem jest powiązana domena.
- Jednostka organizacyjna
- Podrzędna jednostka organizacyjna konta Google Workspace używana do grupowania i sortowania użytkowników na potrzeby stosowania zasad i przyznawania autoryzacji. Jednostka organizacyjna jest reprezentowana przez zasób OrgUnit.
- Uprawnienia
- Możliwość wykonania przez użytkownika działania na zasobie w Google Workspace. Dotyczy głównie administratorów. Uprawnienia są reprezentowane przez zasób Uprawnienie.
- Role
- Zdefiniowana kolekcja uprawnień, które można przypisać do użytkownika lub zbioru użytkowników za pomocą zasobu Rola.
- Przypisanie roli
- Rekord wskazujący, który użytkownik ma przypisane role i w jakim zakresie. Przypisanie roli jest reprezentowane przez zasób RoleAssignment.
- Schemat
- Obiekt JSON definiujący niestandardowe atrybuty użytkowników w Twojej organizacji, reprezentowane przez zasób Schemat.
- Użytkownik
- Kont użytkowników z dostępem do aplikacji i zasobów Google Workspace reprezentowanych przez zasób Użytkownik.
Dalsze kroki
Więcej informacji o programowaniu z użyciem interfejsów Google Workspace API, w tym dotyczących uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako programista Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację Directory API, skorzystaj z krótkiego wprowadzenia w języku JavaScript.