Les brouillons représentent les messages non envoyés auxquels le libellé système DRAFT
a été appliqué.
Une fois créé, le message contenu dans le brouillon ne peut pas être modifié, mais il peut être remplacé. En ce sens, la ressource brouillon est simplement un conteneur qui fournit un ID stable, car les ID de message sous-jacents changent chaque fois que le message est remplacé.
Les ressources de message dans un brouillon se comportent de la même manière que les autres messages, à quelques différences près:
- Les brouillons ne peuvent être associés à aucun libellé autre que le libellé système
DRAFT
. - Lorsque le brouillon est envoyé, il est automatiquement supprimé et un message avec un ID mis à jour est créé avec le libellé système
SENT
. Ce message est renvoyé dans la réponsedrafts.send
.
Sommaire
Créer des brouillons
Votre application peut créer des brouillons à l'aide de la méthode drafts.create. Le processus général consiste à:
- Créez un message MIME conforme à la norme RFC 2822.
- Convertissez le message en une chaîne encodée en base64url.
- Créez un brouillon en définissant la valeur du champ
drafts.message.raw
sur la chaîne encodée.
Les exemples de code suivants illustrent ce processus.
Java
Python
Mise à jour des brouillons
Comme pour la création d'un brouillon, pour mettre à jour un brouillon, vous devez fournir une ressource Draft
dans le corps de votre requête avec le champ draft.message.raw
défini sur une chaîne encodée en base64url contenant le message MIME. Comme les messages ne peuvent pas être mis à jour, le message contenu dans le brouillon est détruit et remplacé par le nouveau message MIME fourni dans la requête de mise à jour.
Vous pouvez récupérer le message MIME actuel du brouillon en appelant drafts.get
avec le paramètre format=raw
.
Pour en savoir plus, consultez drafts.update
.
Envoi de brouillons
Lorsque vous envoyez un brouillon, vous pouvez choisir d'envoyer le message tel quel ou comme s'il s'agissait d'un message mis à jour. Si vous mettez à jour le contenu du brouillon avec un nouveau message, indiquez une ressource Draft
dans le corps de la requête drafts.send
. Définissez l'élément draft.id
du brouillon à envoyer, puis définissez le champ draft.message.raw
sur le nouveau message MIME encodé en base64url. Pour en savoir plus, consultez drafts.send
.