Admin SDK: Directory API

Interfejs Directory API pakietu Admin SDK umożliwia administratorom domen firmowych wyświetlanie użytkowników, grup, urządzeń i powiązanych zasobów organizacji oraz zarządzanie nimi. Interfejsy Cloud Identity API oferują dodatkowe sposoby zarządzania niektórymi z tych samych zasobów.

Usługa: admin.googleapis.com

Zalecamy wywołanie tej usługi przy użyciu dostarczonych przez Google bibliotek klienta. Jeśli aplikacja musi wywoływać tę usługę przy użyciu własnych bibliotek, podczas tworzenia żądań interfejsu API należy używać poniższych informacji.

Dokument opisujący

Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i sposób ich używania. 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 niego:

  • https://admin.googleapis.com

Zasób REST: asps

Metody
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
Usuwa ASP wydany przez użytkownika.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Pobiera informacje o dostawcy usług aplikacji wydanym przez użytkownika.
list GET /admin/directory/v1/users/{userKey}/asps
Wyświetla listę ASP wydanych przez użytkownika.

Zasób REST: chromeosdevices

Metody
action
(deprecated)
POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Zamiast niej używaj BatchChangeChromeOsDeviceStatus.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Pobiera właściwości urządzenia z ChromeOS.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
Pobiera stronicowaną listę urządzeń z ChromeOS na koncie.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Przenosi lub wstawia wiele urządzeń z ChromeOS do jednostki organizacyjnej.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aktualizuje właściwości urządzenia, które można aktualizować, 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 aktualizować, 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 partii urządzeń z ChromeOS.
countChromeOsDevices GET /admin/directory/v1/customer/{customerId}/devices/chromeos:countChromeOsDevices
Zlicza urządzenia z ChromeOS pasujące do żądania.
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ądzeniu.

Zasób REST: customers

Metody
get GET /admin/directory/v1/customers/{customerKey}
Pobiera klienta.
patch PATCH /admin/directory/v1/customers/{customerKey}
Aktualizuje klienta.
update PUT /admin/directory/v1/customers/{customerKey}
Aktualizuje 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 aliasy domen 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 na podstawie klucza użytkownika (stronicowane).
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 stronicowaną 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 działanie, które ma wpływ 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 stronicowaną listę wszystkich urządzeń mobilnych należących do użytkowników na koncie.

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 na koncie.
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 stronicowaną 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 na koncie.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Łata 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 na koncie.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Aktualizuje 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 funkcję.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Pobiera funkcję.
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}
Aktualizuje 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 stronicowaną listę wszystkich przypisań ról.

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 stronicowaną listę wszystkich ról w domenie.
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
Aktualizuje 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 klienta.
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Zmienia 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 wystawione 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 wydanych przez określonego użytkownika na potrzeby 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 użytkownika.
list GET /admin/directory/v1/users
Pobiera stronicowaną listę usuniętych użytkowników lub wszystkich użytkowników w domenie.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
Przypisuje użytkownikowi rolę superadministratora.
patch PATCH /admin/directory/v1/users/{userKey}
Aktualizuje użytkownika przy użyciu semantyki poprawki.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Wylogowuje użytkownika ze wszystkich sesji w internecie i na urządzeniach oraz resetuje jego pliki cookie logowania.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Przywraca usunięte konto użytkownika.
update PUT /admin/directory/v1/users/{userKey}
Aktualizuje użytkownika.
watch POST /admin/directory/v1/users/watch
Śledzi 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
Śledzi 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
Generuje 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.