Admin SDK: Directory API

L'API Admin SDK Directory consente agli amministratori dei domini aziendali di visualizzare e gestire utenti, gruppi, dispositivi e risorse correlate dell'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, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile dalle macchine per la descrizione e l'utilizzo delle 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 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}
Elimina una ASP inviata da un utente.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Consente di ottenere informazioni su una ASP emessa da un utente.
list GET /admin/directory/v1/users/{userKey}/asps
Elenca le ASP rilasciate 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 impaginato dei dispositivi ChromeOS 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}
Consente di aggiornare le proprietà aggiornabili di un dispositivo, come annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Consente di aggiornare le proprietà aggiornabili di un dispositivo, come 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 gruppo di dispositivi ChromeOS.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Invia un comando che il dispositivo deve eseguire.

Risorsa REST: customer.devices.chromeos.commands

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

Risorsa REST: customers

Metodi
get GET /admin/directory/v1/customers/{customerKey}
Recupera un cliente.
patch PATCH /admin/directory/v1/customers/{customerKey}
Apporta patch a un cliente.
update PUT /admin/directory/v1/customers/{customerKey}
Consente di aggiornare un cliente.

Risorsa REST: domainAliases

Metodi
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Elimina 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 cui è stato assegnato un valore userKey (impaginato).
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 per 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}
Verifica se l'utente specificato fa parte 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 impaginato di tutti i membri di un gruppo.
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Aggiorna le proprietà di appartenenza di un utente nel gruppo specificato.
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Consente di aggiornare 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 ha impatto su 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 impaginato di tutti i dispositivi mobili di proprietà degli utenti 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=**}
Consente di aggiornare un'unità organizzativa.
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Consente di aggiornare un'unità organizzativa.

Risorsa REST: privilegi

Metodi
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
Recupera un elenco impaginato di tutti i privilegi assegnati a 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}
Apporta le patch a un edificio.
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Consente di aggiornare 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 di 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 un elemento.
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}
Consente di aggiornare 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 del 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 impaginato di tutte le assegnazioni Role.

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 impaginato 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 la patch a uno schema.
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Aggiorna uno schema.

Risorsa REST: token

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 che l'utente ha emesso nei confronti di 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 impaginato 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 della patch.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Consente di disconnettere un utente da tutte le sessioni web e del dispositivo e reimposta i cookie di accesso.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Annulla l'eliminazione di un utente eliminato.
update PUT /admin/directory/v1/users/{userKey}
Consente di aggiornare un utente.
watch POST /admin/directory/v1/users/watch
Verifica la presenza di 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 per un utente.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
Verifica la presenza di 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 per l'utente.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
Aggiunge una foto per l'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
Annulla la validità dei 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.