Los borradores representan los mensajes no enviados con la etiqueta del sistema DRAFT
aplicada.
El mensaje incluido en el borrador no se puede editar una vez creado, pero
pueden reemplazarse. En este sentido,
recurso borrador es simplemente un contenedor
que proporciona un ID estable porque los IDs de mensajes subyacentes cambian cada vez
se reemplaza el mensaje.
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 ninguna etiqueta que no sea la etiqueta del sistema
DRAFT
. - Cuando se envía el borrador, este se elimina automáticamente y aparece un mensaje nuevo.
con un ID actualizado se crea con la etiqueta del sistema
SENT
. Este mensaje es que se devuelve endrafts.send
respuesta.
Contenido
Creando borradores de mensajes
Tu aplicación puede crear borradores con el drafts.create. El general es el siguiente:
- Crea un mensaje MIME que cumpla con los RFC 2822:
- Convierte el mensaje en una cadena codificada en base64url.
- Crear un borrador y configura la
del campo
drafts.message.raw
a la cadena codificada.
En los siguientes ejemplos de código, se demuestra el proceso.
Java
Python
Actualizando borradores
Al igual que cuando se crea un borrador, debes proporcionar un Draft
para actualizarlo.
en el cuerpo de la solicitud con el campo draft.message.raw
establecer en una cadena codificada en base64url que contiene el mensaje MIME. Porque
los mensajes no se pueden actualizar, el mensaje incluido en el borrador se destruye
y se reemplazará por el nuevo mensaje MIME proporcionado en la solicitud de actualización.
Para recuperar el mensaje MIME actual contenido en el borrador, llama a
drafts.get
por el parámetro
format=raw
Para obtener más información, consulta drafts.update
Enviando borradores
Cuando envías un borrador, puedes elegir enviar el mensaje tal como está o como con un
mensaje actualizado. Si quieres actualizar el borrador de contenido con un mensaje nuevo, haz lo siguiente:
Proporciona un recurso Draft
en el cuerpo del
drafts.send
solicitud; establece la
draft.id
del borrador que se enviará; y establece el campo draft.message.raw
en el
nuevo mensaje MIME codificado como una cadena codificada en base64url. Para ver más
consulta drafts.send
.