Method: users.settings.cse.identities.list

Elenca le identità con crittografia lato client per un utente autenticato.

Per gli amministratori che gestiscono identità e coppie di chiavi per gli utenti della propria organizzazione, le richieste richiedono l'autorizzazione con un service account che disponga dell'autorizzazione di delega a livello di dominio per rappresentare gli utenti con l'ambito https://www.googleapis.com/auth/gmail.settings.basic.

Per gli utenti che gestiscono le proprie identità e coppie di chiavi, le richieste richiedono l'attivazione e la configurazione della crittografia della chiave hardware.

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

string

L'indirizzo email principale del richiedente. Per indicare l'utente autenticato, puoi utilizzare il valore speciale me.

Parametri di query

Parametri
pageToken

string

Token di paginazione che indica quale pagina di identità restituire. Se il token non viene fornito, l'API restituirà la prima pagina dei risultati.
pageSize

integer

Il numero di identità da restituire. Se non viene fornito, la dimensione della pagina sarà impostata per impostazione predefinita su 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 (CseIdentity)
    }
  ],
  "nextPageToken": string
}
Campi
cseIdentities[]

object (CseIdentity)

Una pagina dell'elenco delle identità di crittografia lato client configurate per l'utente.
nextPageToken

string

Token di paginazione da passare a una successiva chiamata identities.list per recuperare la pagina successiva di identità. Se questo valore non viene restituito o è la stringa vuota, non rimangono altre pagine.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

Per saperne di più, consulta la OAuth 2.0 Overview.