Il existe deux façons d'envoyer des e-mails à l'aide de l'API Gmail:
- Vous pouvez l'envoyer directement à l'aide de la méthode
messages.send
. - Vous pouvez l'envoyer à partir d'un brouillon à l'aide de la méthode
drafts.send
.
Les e-mails sont envoyés sous forme de chaînes encodées en base64url dans la propriété raw
d'une ressource de message. Voici le workflow général pour l'envoi d'un e-mail:
- Créez le contenu de l'e-mail d'une 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 avez choisis.
Créer des messages
L'API Gmail nécessite des messages e-mail MIME conformes à la 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 le processus de création et d'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 e-mail peut être considérablement simplifiée avec la classe MimeMessage
du package javax.mail.internet
. L'exemple suivant montre comment créer l'e-mail, 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 pour une chaîne base64url et l'attribuer au champ raw
de la ressource Message
:
Créer des messages avec des pièces jointes
Créer un message avec une pièce jointe revient à créer tout autre message. Toutefois, le processus d'importation du fichier en tant que message MIME en plusieurs parties dépend du langage de programmation. Les exemples de code suivants illustrent différents moyens de créer un message MIME en plusieurs parties avec une pièce jointe.
Java
L'exemple suivant montre comment créer un message MIME en plusieurs parties. 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 son attribution 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 s'affiche dans le fil de discussion, vérifiez les points suivants:
- Les en-têtes
Subject
correspondent. - Les en-têtes
References
etIn-Reply-To
respectent la norme RFC 2822.
Pour plus d'informations sur l'envoi d'un message à partir d'un brouillon, consultez la page Créer des brouillons.