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. Pour envoyer un e-mail, procédez comme suit:
- 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 choisis.
Créer des messages
L'API Gmail nécessite des e-mails MIME conformes à la norme RFC 2822 et encodés sous forme de 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 dans une 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 une pièce jointe est semblable à celle de n'importe quel autre message, mais 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érentes manières 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 souhaitez que l'e-mail soit placé dans le fil de discussion, vérifiez les points suivants:
- Les en-têtes
Subject
correspondent - Les en-têtes
References
etIn-Reply-To
sont conformes à la norme RFC 2822.
Pour plus d'informations sur l'envoi d'un message à partir d'un brouillon, consultez la section Créer des brouillons.