Admin SDK: Directory API

L'API Directory di SDK Admin consente agli amministratori dei domini aziendali di visualizzare e gestire utenti, gruppi, dispositivi e risorse correlate della propria 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 una macchina 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 potrebbe 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}
Elimina un ASP emesso da un utente.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Recupera informazioni su un ASP emesso da un utente.
list GET /admin/directory/v1/users/{userKey}/asps
Elenca gli ASP emessi da un utente.

Risorsa REST: chromeosdevices

Metodi
action
(deprecated)		 POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Utilizza invece 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 di 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.
countChromeOsDevices GET /admin/directory/v1/customer/{customerId}/devices/chromeos:countChromeOsDevices
Conta i dispositivi ChromeOS che corrispondono alla richiesta.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Esegue un comando per il dispositivo.

Risorsa REST: customer.devices.chromeos.commands

Metodi
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
Recupera 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}
Applica una 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}
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 dato un 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 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 nel 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 impaginato 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 del 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 del calendario.
list GET /admin/directory/v1/customer/{customer}/resources/calendars
Recupera un elenco di risorse del calendario per un account.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Applica una patch a una risorsa del calendario.
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Aggiorna una risorsa del 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 una patch a una funzionalità.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
Rinomina una funzionalità.
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 di ruolo.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Recupera un elenco impaginato di tutte le assegnazioni di ruolo.

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

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 una 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 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 specificato ha emesso 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 di 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 sui dispositivi e reimposta i suoi cookie di accesso.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Annulla l'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 per un utente.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
Monitora 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 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
Rende non validi i codici di verifica di backup attuali 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.