Aller à la documentation
Serveur MCP

Brouillons

Les messages non envoyés enregistrés dans la boîte aux lettres.

Outils Brouillons

OutilCe qu'il fait
listDraftsLes brouillons, du plus récemment enregistré au plus ancien, chacun avec son objet, ses destinataires et son expéditeur. query les recherche.
getDraftUn brouillon en entier : son expéditeur, ses destinataires, son objet, le fil auquel il répond, ses pièces jointes et son corps.
createDraftEnregistrer un nouveau brouillon sans l'envoyer. Chaque champ est facultatif, et threadId en fait une réponse.
updateDraftModifier des champs d'un brouillon. Un champ omis garde sa valeur, et une liste remplace entièrement celle qui est enregistrée.
deleteDraftSupprimer définitivement un brouillon. Il ne passe pas par la corbeille.

Lire demande « Lire les brouillons » (drafts:read), et enregistrer, modifier ou supprimer demande « Créer et modifier des brouillons » (drafts:write). Un client limité à certaines adresses ne voit que les brouillons de ces adresses, et un brouillon qu'il enregistre doit avoir un from depuis lequel il peut envoyer.

Dans le chat de l'application, enregistrer, modifier et supprimer un brouillon demande d'abord confirmation, sauf si vous l'avez demandé.

Référence

listDrafts

Portéesdrafts:readL'assistant de l'application l'exécute sans demanderBoîte à outilsdrafts

The unsent drafts in the mailbox, most recently saved first, each with its id, subject, recipients and sender. query searches the subject, the sender and the start of the body. When more follow, the last line gives a pageToken: call again with the same query and that pageToken.

Entrées

querystring
limitinteger
Au moins 1Au plus 100
pageTokenstring

Aussi disponible dans

API
GET /drafts
SDK
drafts.list()drafts.listAll()drafts.iterate()

getDraft

Portéesdrafts:readL'assistant de l'application l'exécute sans demanderBoîte à outilsdrafts

One draft in full: its sender, recipients, subject, the thread it replies to, the names of its attachments and its body as saved. Take the id from listDrafts.

Entrées

draftIdstringObligatoire
Non vide

Aussi disponible dans

API
GET /drafts/{id}
SDK
drafts.get()

createDraft

Portéesdrafts:writeL'assistant de l'application demande d'abord, sauf si vous l'avez demandéBoîte à outilsdrafts

Save a new draft without sending it, as the composer does when you close it. Every field is optional, and html wins over text when both are given. from is the address it will be sent as, and threadId makes it a reply to that thread. sendEmail with the draft id sends it later.

Entrées

tostring[]
ccstring[]
bccstring[]
subjectstring
Jusqu'à 998 caractères
htmlstring
Jusqu'à 1000000 caractères
textstring
Jusqu'à 1000000 caractères
fromstring
threadIdstring

Aussi disponible dans

API
PATCH /drafts/{id}POST /drafts
SDK
drafts.update()drafts.create()

updateDraft

Portéesdrafts:writeL'assistant de l'application demande d'abord, sauf si vous l'avez demandéBoîte à outilsdrafts

Change fields on a saved draft. A field you leave out keeps its value, and a list you give replaces the saved one whole, so to with one address drops the others. from null clears the sender. Take the id from listDrafts.

Entrées

draftIdstringObligatoire
Non vide
tostring[]
ccstring[]
bccstring[]
subjectstring
Jusqu'à 998 caractères
htmlstring
Jusqu'à 1000000 caractères
textstring
Jusqu'à 1000000 caractères
fromstring
Peut être null
threadIdstring

Aussi disponible dans

API
PATCH /drafts/{id}POST /drafts
SDK
drafts.update()drafts.create()

deleteDraft

Portéesdrafts:writeL'assistant de l'application demande d'abord, sauf si vous l'avez demandéBoîte à outilsdrafts

Delete a draft for good. It does not go to the Bin and cannot be brought back. Take the id from listDrafts.

Entrées

draftIdstringObligatoire
Non vide

Aussi disponible dans

API
DELETE /drafts/{id}
SDK
drafts.delete()