Admin SDK: Directory API

Interfejs Admin SDK Directory API pozwala administratorom domen firmowych na wyświetlanie użytkowników, grup, urządzeń i powiązanych zasobów organizacji oraz zarządzanie nimi. Interfejsy Cloud Identity API zapewniają dodatkowe sposoby zarządzania niektórymi tymi samymi zasobami.

Usługa: admin.googleapis.com

Aby wywołać tę usługę, zalecamy użycie dostarczonych przez Google bibliotek klienta. Jeśli do wywoływania tej usługi aplikacja musi używać własnych bibliotek, podczas tworzenia żądań do interfejsu API użyj podanych niżej informacji.

Dokument opisujący

Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i korzystanie z nich. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI odnoszą się do tego punktu końcowego:

  • https://admin.googleapis.com

Zasób REST: asps

Metody
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
Usuwa hasło aplikacji wysłane przez użytkownika.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Pobiera informacje o hasłach aplikacji wydanych przez użytkownika.
list GET /admin/directory/v1/users/{userKey}/asps
Zawiera listę haseł aplikacji utworzonych przez użytkownika.

Zasób REST: chromeosdevices

Metody
action
(deprecated)
POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Zamiast tego użyj zdarzenia BatchChangeChromeOsDeviceStatus.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Pobiera właściwości urządzenia z Chrome OS.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
Pobiera listę urządzeń z Chrome OS podzieloną na strony na koncie.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Przenosi lub wstawia wiele urządzeń z Chrome OS do jednostki organizacyjnej.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aktualizuje właściwości urządzenia, które można zaktualizować, takie jak annotatedUser, annotatedLocation, notes, orgUnitPath lub annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aktualizuje właściwości urządzenia, które można zaktualizować, takie jak annotatedUser, annotatedLocation, notes, orgUnitPath lub annotatedAssetId.

Zasób REST: customer.devices.chromeos

Metody
batchChangeStatus POST /admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
Zmienia stan grupy urządzeń z ChromeOS.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Wydaje polecenie do wykonania przez urządzenie.

Zasób REST: customer.devices.chromeos.commands

Metody
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
Pobiera dane polecenia wydanego na urządzenie.

Zasób REST: customers

Metody
get GET /admin/directory/v1/customers/{customerKey}
Pobiera klienta.
patch PATCH /admin/directory/v1/customers/{customerKey}
Stosuje poprawki do klienta.
update PUT /admin/directory/v1/customers/{customerKey}
Aktualizowanie klienta.

Zasób REST: domainAliases

Metody
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Usuwa alias domeny klienta.
get GET /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Pobiera alias domeny klienta.
insert POST /admin/directory/v1/customer/{customer}/domainaliases
Wstawia alias domeny klienta.
list GET /admin/directory/v1/customer/{customer}/domainaliases
Wyświetla listę aliasów domeny klienta.

Zasób REST: domains

Metody
delete DELETE /admin/directory/v1/customer/{customer}/domains/{domainName}
Usuwa domenę klienta.
get GET /admin/directory/v1/customer/{customer}/domains/{domainName}
Pobiera domenę klienta.
insert POST /admin/directory/v1/customer/{customer}/domains
Wstawia domenę klienta.
list GET /admin/directory/v1/customer/{customer}/domains
Wyświetla listę domen klienta.

Zasób REST: groups

Metody
delete DELETE /admin/directory/v1/groups/{groupKey}
Usuwa grupę.
get GET /admin/directory/v1/groups/{groupKey}
Pobiera właściwości grupy.
insert POST /admin/directory/v1/groups
Tworzy grupę.
list GET /admin/directory/v1/groups
Pobiera wszystkie grupy domeny lub użytkownika o danym kluczu userKey (z podziałem na strony).
patch PATCH /admin/directory/v1/groups/{groupKey}
Aktualizuje właściwości grupy.
update PUT /admin/directory/v1/groups/{groupKey}
Aktualizuje właściwości grupy.

Zasób REST: groups.aliases

Metody
delete DELETE /admin/directory/v1/groups/{groupKey}/aliases/{alias}
Usuwa alias.
insert POST /admin/directory/v1/groups/{groupKey}/aliases
Dodaje alias grupy.
list GET /admin/directory/v1/groups/{groupKey}/aliases
Wyświetla wszystkie aliasy grupy.

Zasób REST: members

Metody
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Usuwa użytkownika z grupy.
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Pobiera właściwości członka grupy.
hasMember GET /admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
Sprawdza, czy dany użytkownik jest członkiem grupy.
insert POST /admin/directory/v1/groups/{groupKey}/members
Dodaje użytkownika do określonej grupy.
list GET /admin/directory/v1/groups/{groupKey}/members
Pobiera podzieloną na strony listę wszystkich członków grupy.
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Aktualizuje właściwości członkostwa użytkownika w określonej grupie.
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Aktualizuje członkostwo użytkownika w określonej grupie.

Zasób REST: mobiledevices

Metody
action POST /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
Wykonuje czynność, która wpływa na urządzenie mobilne.
delete DELETE /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Usuwa urządzenie mobilne.
get GET /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Pobiera właściwości urządzenia mobilnego.
list GET /admin/directory/v1/customer/{customerId}/devices/mobile
Pobiera podzieloną na strony listę wszystkich urządzeń mobilnych należących do użytkownika dla konta.

Zasób REST: orgunits

Metody
delete DELETE /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Usuwa jednostkę organizacyjną.
get GET /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Pobiera jednostkę organizacyjną.
insert POST /admin/directory/v1/customer/{customerId}/orgunits
Dodaje jednostkę organizacyjną.
list GET /admin/directory/v1/customer/{customerId}/orgunits
Pobiera listę wszystkich jednostek organizacyjnych konta.
patch PATCH /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Aktualizuje jednostkę organizacyjną.
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Aktualizuje jednostkę organizacyjną.

Zasób REST: privileges

Metody
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
Pobiera podzieloną na strony listę wszystkich uprawnień klienta.

Zasób REST: resources.buildings

Metody
delete DELETE /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Usuwa budynek.
get GET /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Pobiera budynek.
insert POST /admin/directory/v1/customer/{customer}/resources/buildings
Wstawia budynek.
list GET /admin/directory/v1/customer/{customer}/resources/buildings
Pobiera listę budynków z konta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Poprawia budynek.
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Aktualizuje budynek.

Zasób REST: resources.calendars

Metody
delete DELETE /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Usuwa zasób kalendarza.
get GET /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Pobiera zasób kalendarza.
insert POST /admin/directory/v1/customer/{customer}/resources/calendars
Wstawia zasób kalendarza.
list GET /admin/directory/v1/customer/{customer}/resources/calendars
Pobiera listę zasobów kalendarza dla konta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Poprawia zasób kalendarza.
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Aktualizuje zasób kalendarza.

Zasób REST: resources.features

Metody
delete DELETE /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Usuwa cechę.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Pobiera cechę.
insert POST /admin/directory/v1/customer/{customer}/resources/features
Wstawia funkcję.
list GET /admin/directory/v1/customer/{customer}/resources/features
Pobiera listę funkcji konta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Poprawia funkcję.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
Zmienia nazwę funkcji.
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Aktualizuje funkcję.

Zasób REST: roleAssignments

Metody
delete DELETE /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Usuwa przypisanie roli.
get GET /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Pobiera przypisanie roli.
insert POST /admin/directory/v1/customer/{customer}/roleassignments
Tworzy przypisanie roli.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Pobiera podzieloną na strony listę wszystkich ról roleAssignments.

Zasób REST: roles

Metody
delete DELETE /admin/directory/v1/customer/{customer}/roles/{roleId}
Usuwa rolę.
get GET /admin/directory/v1/customer/{customer}/roles/{roleId}
Pobiera rolę.
insert POST /admin/directory/v1/customer/{customer}/roles
Tworzy rolę.
list GET /admin/directory/v1/customer/{customer}/roles
Pobiera podzieloną na strony listę wszystkich ról w domenie.
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
Poprawia rolę.
update PUT /admin/directory/v1/customer/{customer}/roles/{roleId}
Aktualizuje rolę.

Zasób REST: schemas

Metody
delete DELETE /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Usuwa schemat.
get GET /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Pobiera schemat.
insert POST /admin/directory/v1/customer/{customerId}/schemas
Tworzy schemat.
list GET /admin/directory/v1/customer/{customerId}/schemas
Pobiera wszystkie schematy dotyczące klienta.
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Poprawia schemat.
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Aktualizuje schemat.

Zasób REST: tokens

Metody
delete DELETE /admin/directory/v1/users/{userKey}/tokens/{clientId}
Usuwa wszystkie tokeny dostępu wydane przez użytkownika dla aplikacji.
get GET /admin/directory/v1/users/{userKey}/tokens/{clientId}
Pobiera informacje o tokenie dostępu wydanym przez użytkownika.
list GET /admin/directory/v1/users/{userKey}/tokens
Zwraca zestaw tokenów wystawionych przez użytkownika dla aplikacji innych firm.

Zasób REST: twoStepVerification

Metody
turnOff POST /admin/directory/v1/users/{userKey}/twoStepVerification/turnOff
Wyłącza weryfikację dwuetapową na koncie użytkownika.

Zasób REST: users

Metody
delete DELETE /admin/directory/v1/users/{userKey}
Usuwa użytkownika.
get GET /admin/directory/v1/users/{userKey}
Pobiera użytkownika.
insert POST /admin/directory/v1/users
Tworzy konto użytkownika.
list GET /admin/directory/v1/users
Pobiera podzieloną na strony listę usuniętych użytkowników lub wszystkich użytkowników w domenie.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
Powoduje, że użytkownik staje się superadministratorem.
patch PATCH /admin/directory/v1/users/{userKey}
Aktualizuje użytkownika za pomocą semantyki poprawki.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Wylogowuje użytkownika ze wszystkich sesji w internecie i na urządzeniu oraz resetuje pliki cookie logowania.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Przywraca usunięte konto użytkownika.
update PUT /admin/directory/v1/users/{userKey}
Aktualizacja użytkownika.
watch POST /admin/directory/v1/users/watch
Sprawdza zmiany na liście użytkowników.

Zasób REST: users.aliases

Metody
delete DELETE /admin/directory/v1/users/{userKey}/aliases/{alias}
Usuwa alias.
insert POST /admin/directory/v1/users/{userKey}/aliases
Dodaje alias.
list GET /admin/directory/v1/users/{userKey}/aliases
Wyświetla wszystkie aliasy użytkownika.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
Sprawdza zmiany na liście użytkowników.

Zasób REST: users.photos

Metody
delete DELETE /admin/directory/v1/users/{userKey}/photos/thumbnail
Usuwa zdjęcie użytkownika.
get GET /admin/directory/v1/users/{userKey}/photos/thumbnail
Pobiera zdjęcie użytkownika.
patch PATCH /admin/directory/v1/users/{userKey}/photos/thumbnail
Dodaje zdjęcie użytkownika.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
Dodaje zdjęcie użytkownika.

Zasób REST: verificationCodes

Metody
generate POST /admin/directory/v1/users/{userKey}/verificationCodes/generate
Wygeneruje nowe zapasowe kody weryfikacyjne dla użytkownika.
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
Unieważnia bieżące zapasowe kody weryfikacyjne użytkownika.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
Zwraca bieżący zestaw prawidłowych zapasowych kodów weryfikacyjnych dla określonego użytkownika.