Los borradores representan mensajes no enviados con la etiqueta de sistema DRAFT
aplicada.
Una vez que se crea el mensaje del borrador, no se puede editar, pero sí puedes reemplazarlo. En este sentido, el recurso borrador es simplemente un contenedor que proporciona un ID estable porque los ID de mensajes subyacentes cambian cada vez que se reemplaza el mensaje.
Los recursos de mensajes dentro de un borrador tienen un comportamiento similar a otros mensajes, excepto por las siguientes diferencias:
- Los borradores de mensajes no pueden tener otra etiqueta que no sea la etiqueta del sistema
DRAFT
. - Cuando se envía el borrador, este se borra automáticamente y se crea un mensaje nuevo con un ID actualizado con la etiqueta del sistema
SENT
. Este mensaje se muestra en la respuestadrafts.send
.
Contenido
Crear borradores de mensajes
Tu aplicación puede crear borradores con el método drafts.create. El proceso general consiste en lo siguiente:
- Crea un mensaje MIME que cumpla con RFC 2822.
- Convierte el mensaje en una string codificada en base64url.
- Crea un borrador y configura el valor del campo
drafts.message.raw
como la string codificada.
En los siguientes ejemplos de código, se demuestra el proceso.
Java
Python
Actualizando borradores
Al igual que cuando se crea un borrador, para actualizar un borrador debes proporcionar un recurso Draft
en el cuerpo de tu solicitud con el campo draft.message.raw
configurado como una string codificada en base64url que contenga el mensaje MIME. Debido a que los mensajes no se pueden actualizar, el mensaje contenido en el borrador se destruye y se reemplaza por el nuevo mensaje MIME proporcionado en la solicitud de actualización.
Puedes recuperar el mensaje MIME actual contenido en el borrador llamando a drafts.get
con el parámetro format=raw
.
Para obtener más información, consulta drafts.update
.
Cómo enviar borradores
Cuando envías un borrador, puedes elegir enviar el mensaje tal como está o con uno actualizado. Si actualizas el contenido en borrador con un mensaje nuevo, proporciona un recurso Draft
en el cuerpo de la solicitud drafts.send
, configura el draft.id
del borrador que se enviará y establece el campo draft.message.raw
en el nuevo mensaje MIME codificado como una string codificada en base64url. Para obtener más información, consulta drafts.send
.