Questo documento spiega come creare, aggiornare e inviare bozze di email utilizzando l'API Gmail.
Le bozze di email rappresentano messaggi non inviati a cui è 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
drafts risorsa è un
container che fornisce un ID stabile perché gli ID dei messaggi 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:
- I messaggi di bozza non possono avere etichette diverse dall'etichetta 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 nelladrafts.sendrisposta del metodo.
Creare bozze
La tua app può creare bozze utilizzando il
drafts.create
metodo. 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 delmessages.rawcampo sulla stringa codificata.
I seguenti esempi di codice illustrano la procedura:
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 a l'API.
- MESSAGE: il messaggio MIME formattato RFC 2822, codificato come base64URL.
Aggiornare 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
drafts.get metodo
con il parametro di query format=raw.
Per ulteriori informazioni, consulta il
drafts.update
metodo.
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 l'
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.