Admin SDK: Directory API

L'API Directory dell'SDK Admin consente agli amministratori dei domini aziendali di visualizzare e gestire gli utenti, i gruppi, i dispositivi e le risorse correlate della loro organizzazione. Le API Cloud Identity offrono altri modi per gestire alcune delle stesse risorse.

Servizio: admin.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, utilizza le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile da computer per descrivere e utilizzare le API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI riportati di seguito sono relativi a questo endpoint di servizio:

  • https://admin.googleapis.com

Risorsa REST: asps

Metodi
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
Consente di eliminare un ASP emesso da un utente.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Recupera le informazioni su un ASP emesso da un utente.
list GET /admin/directory/v1/users/{userKey}/asps
Elenca le ASP emesse da un utente.

Risorsa REST: chromeosdevices

Metodi
action
(deprecated)
POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Utilizza BatchChangeChromeOsDeviceStatus.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Recupera le proprietà di un dispositivo ChromeOS.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
Recupera un elenco paginato dei dispositivi Chrome OS all'interno di un account.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Sposta o inserisce più dispositivi ChromeOS in un'unità organizzativa.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aggiorna le proprietà aggiornabili di un dispositivo, ad esempio annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Aggiorna le proprietà aggiornabili di un dispositivo, ad esempio annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

Risorsa REST: customer.devices.chromeos

Metodi
batchChangeStatus POST /admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
Modifica lo stato di un batch di dispositivi ChromeOS.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Invia un comando da eseguire sul dispositivo.

Risorsa REST: customer.devices.chromeos.commands

Metodi
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
Recupera i dati di comando di un comando specifico emesso al dispositivo.

Risorsa REST: customers

Metodi
get GET /admin/directory/v1/customers/{customerKey}
Recupera un cliente.
patch PATCH /admin/directory/v1/customers/{customerKey}
Applica patch a un cliente.
update PUT /admin/directory/v1/customers/{customerKey}
Aggiorna un cliente.

Risorsa REST: domainAliases

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Consente di eliminare un alias di dominio del cliente.
get GET /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Recupera un alias di dominio del cliente.
insert POST /admin/directory/v1/customer/{customer}/domainaliases
Inserisce un alias di dominio del cliente.
list GET /admin/directory/v1/customer/{customer}/domainaliases
Elenca gli alias di dominio del cliente.

Risorsa REST: domains

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/domains/{domainName}
Elimina un dominio del cliente.
get GET /admin/directory/v1/customer/{customer}/domains/{domainName}
Recupera un dominio del cliente.
insert POST /admin/directory/v1/customer/{customer}/domains
Inserisce un dominio del cliente.
list GET /admin/directory/v1/customer/{customer}/domains
Elenca i domini del cliente.

Risorsa REST: groups

Metodi
delete DELETE /admin/directory/v1/groups/{groupKey}
Elimina un gruppo.
get GET /admin/directory/v1/groups/{groupKey}
Recupera le proprietà di un gruppo.
insert POST /admin/directory/v1/groups
Crea un gruppo.
list GET /admin/directory/v1/groups
Recupera tutti i gruppi di un dominio o di un utente a partire da un valore userKey (paginato).
patch PATCH /admin/directory/v1/groups/{groupKey}
Aggiorna le proprietà di un gruppo.
update PUT /admin/directory/v1/groups/{groupKey}
Aggiorna le proprietà di un gruppo.

Risorsa REST: groups.aliases

Metodi
delete DELETE /admin/directory/v1/groups/{groupKey}/aliases/{alias}
Rimuove un alias.
insert POST /admin/directory/v1/groups/{groupKey}/aliases
Aggiunge un alias per il gruppo.
list GET /admin/directory/v1/groups/{groupKey}/aliases
Elenca tutti gli alias di un gruppo.

Risorsa REST: members

Metodi
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Rimuove un membro da un gruppo.
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Recupera le proprietà di un membro del gruppo.
hasMember GET /admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
Controlla se l'utente specificato è membro del gruppo.
insert POST /admin/directory/v1/groups/{groupKey}/members
Aggiunge un utente al gruppo specificato.
list GET /admin/directory/v1/groups/{groupKey}/members
Recupera un elenco paginato di tutti i membri di un gruppo.
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Aggiorna le proprietà di appartenenza di un utente al gruppo specificato.
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Aggiorna l'appartenenza di un utente al gruppo specificato.

Risorsa REST: mobiledevices

Metodi
action POST /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
Esegue un'azione che interessa un dispositivo mobile.
delete DELETE /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Rimuove un dispositivo mobile.
get GET /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Recupera le proprietà di un dispositivo mobile.
list GET /admin/directory/v1/customer/{customerId}/devices/mobile
Recupera un elenco paginato di tutti i dispositivi mobili di proprietà dell'utente per un account.

Risorsa REST: orgunits

Metodi
delete DELETE /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Rimuove un'unità organizzativa.
get GET /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Recupera un'unità organizzativa.
insert POST /admin/directory/v1/customer/{customerId}/orgunits
Aggiunge un'unità organizzativa.
list GET /admin/directory/v1/customer/{customerId}/orgunits
Recupera un elenco di tutte le unità organizzative per un account.
patch PATCH /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Aggiorna un'unità organizzativa.
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Aggiorna un'unità organizzativa.

Risorsa REST: privileges

Metodi
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
Recupera un elenco paginato di tutti i privilegi per un cliente.

Risorsa REST: resources.buildings

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Elimina un edificio.
get GET /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Recupera un edificio.
insert POST /admin/directory/v1/customer/{customer}/resources/buildings
Inserisce un edificio.
list GET /admin/directory/v1/customer/{customer}/resources/buildings
Recupera un elenco di edifici per un account.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Applica patch a un edificio.
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Aggiorna un edificio.

Risorsa REST: resources.calendars

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Elimina una risorsa di calendario.
get GET /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Recupera una risorsa del calendario.
insert POST /admin/directory/v1/customer/{customer}/resources/calendars
Inserisce una risorsa di calendario.
list GET /admin/directory/v1/customer/{customer}/resources/calendars
Recupera un elenco di risorse di calendario per un account.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Applica patch a una risorsa di calendario.
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Aggiorna una risorsa di calendario.

Risorsa REST: resources.features

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Elimina una funzionalità.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Recupera una funzionalità.
insert POST /admin/directory/v1/customer/{customer}/resources/features
Inserisce una funzionalità.
list GET /admin/directory/v1/customer/{customer}/resources/features
Recupera un elenco di funzionalità per un account.
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Applica patch a una funzionalità.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
Rinomina un elemento.
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Aggiorna una funzionalità.

Risorsa REST: roleAssignments

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Elimina un'assegnazione di ruolo.
get GET /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Recupera un'assegnazione di ruolo.
insert POST /admin/directory/v1/customer/{customer}/roleassignments
Crea un'assegnazione del ruolo.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Recupera un elenco paginato di tutti i roleAssignments.

Risorsa REST: roles

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/roles/{roleId}
Elimina un ruolo.
get GET /admin/directory/v1/customer/{customer}/roles/{roleId}
Recupera un ruolo.
insert POST /admin/directory/v1/customer/{customer}/roles
Crea un ruolo.
list GET /admin/directory/v1/customer/{customer}/roles
Recupera un elenco paginato di tutti i ruoli in un dominio.
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
Applica patch a un ruolo.
update PUT /admin/directory/v1/customer/{customer}/roles/{roleId}
Aggiorna un ruolo.

Risorsa REST: schemas

Metodi
delete DELETE /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Elimina uno schema.
get GET /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Recupera uno schema.
insert POST /admin/directory/v1/customer/{customerId}/schemas
Crea uno schema.
list GET /admin/directory/v1/customer/{customerId}/schemas
Recupera tutti gli schemi per un cliente.
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Applica patch a uno schema.
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Aggiorna uno schema.

Risorsa REST: tokens

Metodi
delete DELETE /admin/directory/v1/users/{userKey}/tokens/{clientId}
Elimina tutti i token di accesso emessi da un utente per un'applicazione.
get GET /admin/directory/v1/users/{userKey}/tokens/{clientId}
Recupera le informazioni su un token di accesso emesso da un utente.
list GET /admin/directory/v1/users/{userKey}/tokens
Restituisce l'insieme di token emessi dall'utente specificato per applicazioni di terze parti.

Risorsa REST: twoStepVerification

Metodi
turnOff POST /admin/directory/v1/users/{userKey}/twoStepVerification/turnOff
Disattiva la verifica in due passaggi per l'utente.

Risorsa REST: users

Metodi
delete DELETE /admin/directory/v1/users/{userKey}
Elimina un utente.
get GET /admin/directory/v1/users/{userKey}
Recupera un utente.
insert POST /admin/directory/v1/users
Crea un utente.
list GET /admin/directory/v1/users
Recupera un elenco paginato degli utenti eliminati o di tutti gli utenti di un dominio.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
Imposta un utente come super amministratore.
patch PATCH /admin/directory/v1/users/{userKey}
Aggiorna un utente utilizzando la semantica delle patch.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Disconnette un utente da tutte le sessioni web e del dispositivo e reimposta i suoi cookie di accesso.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Annullamento dell'eliminazione di un utente.
update PUT /admin/directory/v1/users/{userKey}
Aggiorna un utente.
watch POST /admin/directory/v1/users/watch
Monitora le modifiche nell'elenco degli utenti.

Risorsa REST: users.aliases

Metodi
delete DELETE /admin/directory/v1/users/{userKey}/aliases/{alias}
Rimuove un alias.
insert POST /admin/directory/v1/users/{userKey}/aliases
Aggiunge un alias.
list GET /admin/directory/v1/users/{userKey}/aliases
Elenca tutti gli alias di un utente.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
Controlla le modifiche nell'elenco degli utenti.

Risorsa REST: users.photos

Metodi
delete DELETE /admin/directory/v1/users/{userKey}/photos/thumbnail
Rimuove la foto dell'utente.
get GET /admin/directory/v1/users/{userKey}/photos/thumbnail
Recupera la foto dell'utente.
patch PATCH /admin/directory/v1/users/{userKey}/photos/thumbnail
Aggiunge una foto dell'utente.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
Aggiunge una foto dell'utente.

Risorsa REST: verificationCodes

Metodi
generate POST /admin/directory/v1/users/{userKey}/verificationCodes/generate
Genera nuovi codici di verifica di backup per l'utente.
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
Rendono non validi i codici di verifica di backup correnti per l'utente.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
Restituisce l'insieme corrente di codici di verifica di backup validi per l'utente specificato.