Questa pagina è stata tradotta dall'API Cloud Translation.

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:

https://admin.googleapis.com/$discovery/rest?version=directory_v1

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.