Questo documento spiega come creare, aggiornare e inviare bozze di email utilizzando l'API Gmail.
Le bozze di email rappresentano i messaggi non inviati a cui è stata applicata l'etichetta di sistema DRAFT.
Il messaggio contenuto nella bozza non può essere modificato una volta creato, ma può
essere sostituito. In questo senso, la risorsa
drafts è un
contenitore che fornisce un ID stabile perché gli ID messaggio sottostanti cambiano
ogni volta che il messaggio viene sostituito.
La risorsa messages all'interno di una bozza ha un comportamento simile a quello degli altri messaggi, ad eccezione delle seguenti differenze:
- Le bozze di messaggi non possono avere etichette diverse da quella di sistema
DRAFT. - Quando la bozza viene inviata, viene eliminata automaticamente e viene creato un nuovo messaggio
con un ID aggiornato e l'etichetta di sistema
SENT. Questo messaggio viene restituito nella risposta del metododrafts.send.
Creare bozze
La tua app può creare bozze utilizzando il metodo
drafts.create. Per creare una bozza:
- Crea un messaggio MIME conforme a RFC 2822.
- Converti il messaggio in una stringa con codifica base64URL.
- Chiama il metodo
drafts.create, impostando il valore del campomessages.rawsulla stringa codificata.
I seguenti esempi di codice mostrano il processo:
Java
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
Sostituisci quanto segue:
- ACCESS_TOKEN: il token di accesso che concede l'accesso all'API.
- MESSAGE: il messaggio MIME formattato RFC 2822, codificato come base64URL.
Aggiorna le bozze
Analogamente alla creazione di una bozza, per aggiornarla devi fornire una risorsa drafts nel corpo della richiesta con il campo messages.raw impostato su una stringa con codifica base64URL contenente il messaggio MIME. Poiché i messaggi non possono essere
aggiornati, il messaggio contenuto nella bozza viene eliminato e sostituito dal nuovo
messaggio MIME fornito nella richiesta di aggiornamento.
Puoi recuperare il messaggio MIME corrente contenuto nella bozza chiamando il metodo
drafts.get
con il parametro di query format=raw.
Per saperne di più, consulta il metodo
drafts.update.
Inviare bozze
Quando invii una bozza, puoi inviarla così com'è oppure puoi fornire aggiornamenti nella richiesta di invio.
Per aggiornare la bozza durante l'invio, fornisci una risorsa drafts nel corpo della richiesta
del metodo drafts.send. Nella risorsa drafts, devi specificare la bozza
id della bozza da inviare e impostare il campo messages.raw sul nuovo messaggio MIME
codificato come stringa base64URL.
Per informazioni sull'invio di un messaggio Gmail, vedi Inviare messaggi.