- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Elenca le identità con crittografia lato client per un utente autenticato.
Per gli amministratori che gestiscono le identità e le coppie di chiavi per gli utenti della propria organizzazione, le richieste richiedono l'autorizzazione con un account di servizio che abbia autorità di delega a livello di dominio per rubare l'identità degli utenti con l'ambito https://www.googleapis.com/auth/gmail.settings.basic.
Per gli utenti che gestiscono le proprie identità e le proprie coppie di chiavi, le richieste richiedono la crittografia della chiave hardware attivata e configurata.
Richiesta HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
userId |
L'indirizzo email principale del richiedente. Per indicare l'utente autenticato, puoi utilizzare il valore speciale |
Parametri di query
| Parametri | |
|---|---|
pageToken |
Token di paginazione che indica quale pagina di identità restituire. Se il token non viene fornito, l'API restituirà la prima pagina di risultati. |
pageSize |
Il numero di identità da restituire. Se non viene fornito, il valore predefinito per le dimensioni della pagina è 20 voci. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
|---|
{
"cseIdentities": [
{
object ( |
| Campi | |
|---|---|
cseIdentities[] |
Una pagina dell'elenco delle identità CSE configurate per l'utente. |
nextPageToken |
Token di pagina da passare a una successiva chiamata identities.list per recuperare la pagina successiva di identità. Se questo valore non viene restituito o è una stringa vuota, non ci sono altre pagine. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/gmail.settings.basichttps://mail.google.com/https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.settings.sharing
Per ulteriori informazioni, consulta la Guida all'autorizzazione.