Vous pouvez envoyer des e-mails à l'aide de l'API Gmail de deux manières :
- Vous pouvez l'envoyer directement à l'aide de la méthode
messages.send
. - Vous pouvez l'envoyer depuis un brouillon à l'aide de la méthode
drafts.send
.
Les adresses e-mail sont envoyées sous forme de chaînes encodées en base64url dans la propriété raw
d'une ressource de message. Pour envoyer un e-mail, vous devez suivre les étapes suivantes :
- Créez le contenu de l'e-mail de manière pratique et encodez-le en tant que chaîne base64url.
- Créez une ressource de message et définissez sa propriété
raw
sur la chaîne base64url que vous venez de créer. - Appelez
messages.send
ou, si vous envoyez un brouillon,drafts.send
pour envoyer le message.
Les détails de ce workflow peuvent varier en fonction de la bibliothèque cliente et du langage de programmation que vous choisissez.
Créer des messages
L'API Gmail nécessite des messages MIME conformes à la norme RFC 2822 et encodés en tant que chaînes base64url. De nombreux langages de programmation disposent de bibliothèques ou d'utilitaires qui simplifient la création et l'encodage des messages MIME. Les exemples de code suivants montrent comment créer un message MIME à l'aide des bibliothèques clientes des API Google pour différents langages.
Java
La création d'un message électronique peut être considérablement simplifiée grâce à la classe MimeMessage
du package javax.mail.internet
. L'exemple suivant montre comment créer le message électronique, y compris les en-têtes :
L'étape suivante consiste à encoder le MimeMessage
, à instancier un objet Message
et à définir la chaîne de message encodée en base64url comme valeur de la propriété raw
.
Python
L'exemple de code suivant montre comment créer un message MIME, l'encoder en chaîne base64url et l'attribuer au champ raw
de la ressource Message
:
Créer des messages avec des pièces jointes
La création d'un message avec pièce jointe est semblable à celle de tout autre message, mais le processus d'importation du fichier en tant que message MIME multipartite dépend du langage de programmation. Les exemples de code suivants montrent comment créer un message MIME multipart avec une pièce jointe.
Java
L'exemple suivant montre comment créer un message MIME multipart. Les étapes d'encodage et d'attribution sont les mêmes que ci-dessus.
Python
Comme dans l'exemple précédent, cet exemple gère également l'encodage du message en base64url et l'attribue au champ raw
de la ressource Message
.
Envoyer des messages
Une fois que vous avez créé un message, vous pouvez l'envoyer en le fournissant dans le corps de la requête d'un appel à messages.send
, comme illustré dans les exemples suivants.
Java
Python
Si vous essayez d'envoyer une réponse et que vous souhaitez que l'e-mail soit inclus dans un fil de discussion, assurez-vous que :
- Les en-têtes
Subject
correspondent. - Les en-têtes
References
etIn-Reply-To
suivent la norme RFC 2822.
Pour savoir comment envoyer un message à partir d'un brouillon, consultez Créer des brouillons.