Method: users.messages.list

Elenca i messaggi presenti nella casella di posta dell'utente.

Richiesta HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userId

string

L'indirizzo email dell'utente. È possibile utilizzare il valore speciale me per indicare l'utente autenticato.

Parametri di ricerca

Parametri
maxResults

integer (uint32 format)

Numero massimo di messaggi da restituire. L'impostazione predefinita di questo campo è 100. Il valore massimo consentito per questo campo è 500.

pageToken

string

Token di pagina per recuperare una pagina specifica di risultati nell'elenco.

q

string

Restituisci solo i messaggi che corrispondono alla query specificata. Supporta lo stesso formato di query della casella di ricerca di Gmail. Ad esempio, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread". Impossibile utilizzare il parametro quando si accede all'API tramite l'ambito gmail.metadata.

labelIds[]

string

Restituisci solo i messaggi con etichette che corrispondono a tutti gli ID etichetta specificati. I messaggi in un thread potrebbero avere etichette che non hanno gli altri messaggi nello stesso thread. Per scoprire di più, vedi Gestire le etichette di messaggi e thread.

includeSpamTrash

boolean

Includi i messaggi di SPAM e TRASH nei risultati.

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
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Campi
messages[]

object (Message)

Elenco dei messaggi. Tieni presente che ogni risorsa di messaggio contiene solo un id e un threadId. È possibile recuperare ulteriori dettagli dei messaggi utilizzando il metodo messages.get.

nextPageToken

string

Token per recuperare la pagina successiva dei risultati nell'elenco.

resultSizeEstimate

integer (uint32 format)

Numero totale stimato di risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.