Le bozze rappresentano i messaggi non inviati con l'etichetta di sistema DRAFT
applicata.
Una volta creato, il messaggio contenuto nella bozza non può essere modificato, ma può essere sostituito. In questo senso, la risorsa bozza è semplicemente un container che fornisce un ID stabile perché gli ID messaggio sottostanti cambiano ogni volta che il messaggio viene sostituito.
Le risorse dei messaggi all'interno di una bozza hanno un comportamento simile agli altri messaggi, tranne per le seguenti differenze:
- Le bozze dei messaggi non possono avere etichette diverse dall'etichetta di sistema
DRAFT
. - Quando viene inviata, la bozza viene eliminata automaticamente e viene creato un nuovo messaggio con un ID aggiornato con l'etichetta di sistema
SENT
. Questo messaggio viene restituito nella rispostadrafts.send
.
Sommario
Creazione di bozze di messaggi
L'applicazione può creare bozze utilizzando il metodo drafts.create. La procedura generale è:
- Crea un messaggio MIME conforme a RFC 2822.
- Converti il messaggio in una stringa codificata base64url.
- Crea una bozza, impostando il valore del campo
drafts.message.raw
sulla stringa codificata.
I seguenti esempi di codice mostrano il processo.
Java
Python
Aggiornamento bozze
Analogamente alla creazione di una bozza, per aggiornare una bozza devi fornire una risorsa Draft
nel corpo della richiesta con il campo draft.message.raw
impostato su una stringa codificata 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 l'attuale messaggio MIME contenuto nella bozza chiamando drafts.get
con il parametro format=raw
.
Per maggiori informazioni, consulta
drafts.update
.
Invio di bozze
Quando invii una bozza, puoi scegliere di inviarla così com'è o come con un messaggio aggiornato. Se stai aggiornando i contenuti della bozza con un nuovo messaggio, fornisci una risorsa Draft
nel corpo della richiesta drafts.send
, imposta il valore draft.id
della bozza da inviare e il campo draft.message.raw
sul nuovo messaggio MIME codificato come stringa con codifica base64url. Per ulteriori informazioni, consulta drafts.send
.