Interfejs Directory API jest częścią interfejsu API typu RESTful Admin SDK, którego można używać do automatycznego tworzenia zasobów zarządzanych przez administratora należących do konta Google Workspace i zarządzania nimi. Oto niektóre przypadki użycia:
- 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 podejmowanie działań na utraconych urządzeniach;
- Zarządzanie wykresem organizacyjnym i strukturami organizacyjnych.
- Kontrola aplikacji, którym użytkownicy przyznali dostęp i unieważnienie nieautoryzowanych aplikacji.
Poniżej znajduje się lista popularnych 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 (Domena). Nie wszystkie konta mają powiązaną domenę.
- Jednostka organizacyjna
- Jednostka podrzędna drzewa organizacyjnego konta Google Workspace, która służy do grupowania i sortowania użytkowników na potrzeby stosowania zasad i udzielania autoryzacji. Jednostka organizacyjna jest reprezentowana przez zasób OrgUnit.
- Uprawnienie
- Zdolność użytkownika do wykonania działania na zasobie Google Workspace. Dotyczy głównie administratorów. Uprawnienie jest reprezentowane przez zasób Privilege (Uprawnienia).
- Role
- Zdefiniowany zbiór uprawnień, które można przypisać użytkownikowi lub zbiorowi użytkowników, reprezentowany przez zasób Rola.
- Przypisywanie 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, który definiuje niestandardowe atrybuty użytkownika w organizacji, reprezentowany przez zasób Schemat.
- Użytkownik
- Indywidualne 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ę Directory API, zapoznaj się z krótkim wprowadzeniem do JavaScriptu.