Este documento explica como criar, atualizar e enviar e-mails em rascunho usando a API Gmail.
Os rascunhos de e-mail representam mensagens não enviadas com o rótulo do sistema DRAFT aplicado.
A mensagem no rascunho não pode ser editada depois de criada, mas pode ser substituída. Nesse sentido, o recurso
drafts é um
container que fornece um ID estável porque os IDs de mensagem subjacentes mudam
sempre que a mensagem é substituída.
O recurso messages em um rascunho tem um comportamento semelhante ao de outras mensagens, exceto pelas seguintes diferenças:
- As mensagens em rascunho não podem ter nenhum marcador além do marcador do sistema
DRAFT. - Quando o rascunho é enviado, ele é excluído automaticamente, e uma nova mensagem
com um ID atualizado é criada com o marcador do sistema
SENT. Essa mensagem é retornada na resposta do métododrafts.send.
Criar rascunhos
Seu app pode criar rascunhos usando o método
drafts.create. Para criar um rascunho:
- Crie uma mensagem MIME que esteja em conformidade com a RFC 2822.
- Converta a mensagem em uma string codificada em base64URL.
- Chame o método
drafts.create, definindo o valor do campomessages.rawcomo a string codificada.
Os exemplos de código a seguir demonstram o 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"}}'
Substitua:
- ACCESS_TOKEN: o token de acesso que concede acesso à API.
- MESSAGE: a mensagem MIME formatada em RFC 2822, codificada como base64URL.
Atualizar rascunho
Assim como na criação de um rascunho, para atualizar um rascunho, você precisa fornecer um recurso drafts no corpo da solicitação com o campo messages.raw definido como uma string codificada em base64URL que contém a mensagem MIME. Como as mensagens não podem ser atualizadas, a mensagem contida no rascunho é destruída e substituída pela nova mensagem MIME fornecida na solicitação de atualização.
Para recuperar a mensagem MIME atual contida no rascunho, chame o método
drafts.get
com o parâmetro de consulta format=raw.
Para mais informações, consulte o
método
drafts.update.
Enviar rascunhos
Ao enviar um rascunho, você pode enviá-lo como está ou fornecer atualizações na solicitação de envio.
Para atualizar o rascunho ao enviar, forneça um recurso drafts no corpo da solicitação
do método drafts.send. No recurso drafts, especifique o
id do
rascunho a ser enviado e defina o campo messages.raw como a nova mensagem MIME
codificada como uma string base64URL.
Para saber como enviar uma mensagem do Gmail, consulte Enviar mensagens.