Os rascunhos representam as mensagens não enviadas com o marcador de sistema DRAFT
aplicado.
Não é possível editar a mensagem no rascunho, mas ela pode ser substituída. Dessa forma, o
recurso de rascunho é simplesmente um contêiner
que fornece um ID estável, porque os IDs das mensagens mudam sempre
que a mensagem é substituída.
Os recursos de mensagens em um rascunho têm um comportamento semelhante ao de outras mensagens, exceto pelas seguintes diferenças:
- Os rascunhos das mensagens 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 de sistema
SENT
. Essa mensagem é retornada na respostadrafts.send
.
Conteúdo
Como criar mensagens de rascunho
O aplicativo pode criar rascunhos usando o método drafts.create. O processo geral é:
- Crie uma mensagem MIME que obedeça ao RFC 2822.
- Converta a mensagem em uma string codificada em base64url.
- Crie um rascunho, definindo o valor do campo
drafts.message.raw
como a string codificada.
Os exemplos de código a seguir demonstram o processo.
Java
Python
Atualização de rascunhos
Assim como na criação de um rascunho, para atualizá-lo, é necessário fornecer um recurso Draft
no corpo da solicitação com o campo draft.message.raw
definido como uma string codificada em base64url que contém a mensagem MIME. Como não é possível atualizar as mensagens, 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
drafts.get
com o parâmetro
format=raw
.
Para saber mais, consulte
drafts.update
.
Envio de rascunhos
Ao enviar um rascunho, você pode enviar a mensagem no estado em que se encontra ou como uma
mensagem atualizada. Se você estiver atualizando o conteúdo do rascunho com uma nova mensagem,
forneça um recurso Draft
no corpo da
solicitação drafts.send
. Defina o
draft.id
do rascunho a ser enviado e o campo draft.message.raw
como a
nova mensagem MIME codificada como uma string codificada em base64url. Para mais
informações, consulte drafts.send
.