Method: users.drafts.list

Elenca le bozze nella casella di posta dell'utente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userId

string

L'indirizzo email dell'utente. Il valore speciale me può essere utilizzato per indicare l'utente autenticato.

Parametri di query

Parametri
maxResults

integer (uint32 format)

Il numero massimo di bozze da restituire. Il valore predefinito 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 in bozza 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".
includeSpamTrash

boolean

Includi le bozze 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 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Campi
drafts[]

object (Draft)

Elenco delle bozze. Tieni presente che la proprietà Message in ogni risorsa Draft contiene solo un id e un threadId. Il metodo messages.get può recuperare ulteriori dettagli del messaggio.
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.compose
  • https://www.googleapis.com/auth/gmail.readonly

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