Method: users.settings.cse.keypairs.list

Elenca le coppie di chiavi di 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/keypairs

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 coppie di chiavi restituire. Se il token non viene fornito, l'API restituirà la prima pagina dei risultati.

pageSize

integer

Il numero di coppie di chiavi 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
{
  "cseKeyPairs": [
    {
      object (CseKeyPair)
    }
  ],
  "nextPageToken": string
}
Campi
cseKeyPairs[]

object (CseKeyPair)

Una pagina dell'elenco delle coppie di chiavi CSE installate per l'utente.

nextPageToken

string

Token di paginazione da passare a una successiva chiamata keypairs.list per recuperare la pagina successiva di coppie di chiavi. Se questo valore non viene restituito, 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.