Admin SDK: Directory API

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Interfejs Admin SDK Directory API pozwala administratorom domen firmowych wyświetlać użytkowników, grupy, urządzenia i powiązane zasoby w organizacji oraz nimi zarządzać. Interfejsy Cloud Identity API oferują dodatkowe sposoby zarządzania niektórymi z tych samych zasobów.

Usługa: admin.googleapis.com

Aby zadzwonić do tej usługi, zalecamy użycie bibliotek klienckich udostępnionych przez Google. Jeśli Twoja aplikacja musi użyć własnych bibliotek, aby wywołać tę usługę, użyj tych informacji podczas wysyłania żądań do interfejsu API.

Dokument Discovery

Dokument Discovery to zrozumiała dla komputera specyfikacja dotycząca interfejsów API REST i korzystania z nich. Służy do tworzenia bibliotek klientów, wtyczek IDE i innych narzędzi, które współpracują z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów Discovery. 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 określający adres sieci usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych usługi. Ta usługa ma następujący punkt końcowy usługi, a wszystkie poniższe identyfikatory URI są zależne od 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 ASP wydane przez użytkownika.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Pobiera informacje o ASP wydanym przez użytkownika.
list GET /admin/directory/v1/users/{userKey}/asps
Lista ASP wyświetlana przez użytkownika.

Zasób REST: chromeosdevices

Metody
action POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Podejmuje działanie, które wpływa na urządzenie z Chrome OS.
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 na konto listę urządzeń z Chrome OS podzielonych na strony.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Przenosi lub wstawia wiele urządzeń z Chrome OS w jednostce organizacyjnej.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aktualizuje właściwości, które można zaktualizować na urządzeniu, np. annotatedUser, annotatedLocation, notes, orgUnitPath lub annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aktualizuje właściwości, które można zaktualizować na urządzeniu, np. annotatedUser, annotatedLocation, notes, orgUnitPath lub annotatedAssetId.

Zasób REST: customer.devices.chromeos

Metody
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Wydaje polecenie do wykonania na urządzeniu.

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

Metody
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
Pobiera dane polecenia określonego na urządzeniu.

Zasób REST: customers

Metody
get GET /admin/directory/v1/customers/{customerKey}
Pobiera klienta.
patch PATCH /admin/directory/v1/customers/{customerKey}
Klient stosuje poprawki do 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 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
Utworzy grupę.
list GET /admin/directory/v1/groups
Pobiera wszystkie grupy domeny lub użytkownika z przypisanym użytkownikiem userKey (podzielonym 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 członka 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 listę wszystkich członków grupy z podziałem na strony.
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
Podejmuje działanie, które 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 z konta listę wszystkich urządzeń mobilnych należących do użytkownika.

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: permissions

Metody
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
Pobiera listę wszystkich uprawnień klienta z podziałem na strony.

Zasób REST: resources.builds

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 konto.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Ta poprawka oznacza 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 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}
Poprawienie funkcji.
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
Utworzy przypisanie roli.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Pobiera listę wszystkich przypisań z podziałem na strony.

Zasób REST: role.

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
Utworzy rolę.
list GET /admin/directory/v1/customer/{customer}/roles
Pobiera listę wszystkich ról w domenie z podziałem na strony.
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: schemat

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
Utworzy schemat.
list GET /admin/directory/v1/customer/{customerId}/schemas
Pobiera wszystkie schematy dla 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: token

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 wystawionym przez użytkownika.
list GET /admin/directory/v1/users/{userKey}/tokens
Zwraca zestaw tokenów określonych przez użytkownika dla aplikacji innych firm.

Zasób REST: twoStepVerify

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
Utworzy użytkownika.
list GET /admin/directory/v1/users
Pobiera listę użytkowników z podziałem na strony lub wszystkimi użytkownikami w domenie.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
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
Wyloguje użytkownika ze wszystkich sesji internetowych i na urządzeniach oraz zresetuje jego pliki cookie logowania.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Usuwa usunięte konto użytkownika.
update PUT /admin/directory/v1/users/{userKey}
Aktualizuje konto użytkownika.
watch POST /admin/directory/v1/users/watch
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
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.