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 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 remplacement du message.
Les ressources de message d'un brouillon ont un comportement semblable à celui des autres messages, à l'exception des différences suivantes:
- Les brouillons ne peuvent avoir que le libellé système
DRAFT
. - Lorsque le brouillon est envoyé, il est automatiquement supprimé et un nouveau 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éation de 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 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 le 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 en définissant le champ draft.message.raw
sur une chaîne encodée en base64url contenant le message MIME. Étant donné que 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 les sections sur drafts.update
Envoi de brouillons
Lorsque vous envoyez un brouillon, vous pouvez choisir d'envoyer le message tel quel ou avec un message mis à jour. Si vous mettez à jour le brouillon du contenu avec un nouveau message, indiquez une ressource Draft
dans le corps de la requête drafts.send
, définissez le draft.id
du brouillon à envoyer et définissez le champ draft.message.raw
sur le nouveau message MIME encodé en tant que chaîne encodée en base64url. Pour en savoir plus, consultez drafts.send
.