Existen dos maneras de enviar correos electrónicos con la API de Gmail:
- Puedes enviarlo directamente con la
messages.send
. - Puedes enviarlo desde un borrador con la
drafts.send
.
Los correos electrónicos se envían como cadenas codificadas en base64url dentro de la propiedad raw
de un
recurso de mensaje. El enfoque general
flujo de trabajo para enviar un correo electrónico es:
- Crea el contenido del correo electrónico de una manera conveniente y codifícalo como un archivo base64url.
- Crea un nuevo recurso de mensaje y establece su propiedad
raw
en base64url de la cadena que acabas de crear. - Llama a
messages.send
o, en caso de enviar un borrador, adrafts.send
. para enviar el mensaje.
Los detalles de este flujo de trabajo pueden variar en función de la elección del cliente. un lenguaje de programación y una biblioteca.
Creación de mensajes
La API de Gmail requiere que los mensajes de correo electrónico MIME cumplan con RFC 2822 y codificadas como cadenas base64url. Muchos lenguajes de programación tienen bibliotecas o utilidades que simplifican el proceso de creación y codificación de MIME mensajes nuevos. Los siguientes ejemplos de código demuestran cómo crear un mensaje MIME con bibliotecas cliente de APIs de Google para varios lenguajes.
Java
La creación de un mensaje de correo electrónico se puede simplificar en gran medida con MimeMessage
.
en el paquete javax.mail.internet
. En el siguiente ejemplo, se muestra cómo
para crear el mensaje de correo electrónico, incluidos los encabezados:
El siguiente paso es codificar el MimeMessage
y crear una instancia de Message
y establece la cadena de mensaje codificada en base64url como el valor del
propiedad raw
.
Python
El siguiente ejemplo de código demuestra la creación de un mensaje MIME, la codificación para
una cadena base64url y la asignamos al campo raw
de Message
recurso:
Creación de mensajes con archivos adjuntos
Crear un mensaje con un archivo adjunto es como crear cualquier otro mensaje, pero el proceso de subir el archivo como un MIME de varias partes depende del lenguaje de programación. El siguiente código los ejemplos demuestran posibles formas de crear un mensaje MIME de varias partes con un archivo adjunto.
Java
En el siguiente ejemplo, se muestra cómo crear un mensaje MIME de varias partes, la los pasos de codificación y asignación son los mismos que se indican más arriba.
Python
Al igual que en el ejemplo anterior, este ejemplo también controla la codificación de
mensaje a base64url y asignarlo al campo raw
de Message
recurso.
Cómo mandar mensajes
Cuando hayas creado un mensaje, podrás enviarlo incluyéndolo en
cuerpo de la solicitud de llamada a
messages.send
, como se demuestra
en los siguientes ejemplos.
Java
Python
Si intentas enviar una respuesta y quieres que el correo electrónico se convierta en una conversación, asegúrate de lo siguiente:
- Los encabezados
Subject
coinciden. - Los encabezados
References
yIn-Reply-To
siguen los el estándar RFC 2822.
Para obtener información sobre cómo enviar un mensaje desde un borrador, consulta Cómo crear borradores.