Черновики
Неотправленные письма, сохранённые в почтовом ящике.
Инструменты черновиков
| Инструмент | Что делает |
|---|---|
| listDrafts | Черновики, сначала сохранённые последними, каждый с темой, получателями и отправителем. query ищет по ним. |
| getDraft | Один черновик целиком: отправитель, получатели, тема, цепочка, на которую он отвечает, вложения и тело. |
| createDraft | Сохранить новый черновик, не отправляя его. Все поля необязательны, а threadId делает его ответом. |
| updateDraft | Изменить поля черновика. Поле, которое вы не указали, сохраняет своё значение, а список заменяет сохранённый целиком. |
| deleteDraft | Удалить черновик навсегда. В корзину он не попадает. |
Чтение требует «Read drafts» (drafts:read), а сохранение, изменение или удаление требуют «Create and edit drafts» (drafts:write). Клиент, ограниченный некоторыми адресами, видит только черновики с них, а сохраняемому им черновику нужен from, от имени которого он может отправлять.
В чате приложения сохранение, изменение и удаление черновика сначала спрашивают, если только вы сами об этом не попросили.
Справочник
listDrafts
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.
Входные данные
querystringlimitinteger- Не меньше 1Не больше 100
pageTokenstring
Также доступно в
getDraft
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.
Входные данные
draftIdstringОбязательно- Не пустое
Также доступно в
createDraft
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.
Входные данные
tostring[]ccstring[]bccstring[]subjectstring- До 998 символов
htmlstring- До 1000000 символов
textstring- До 1000000 символов
fromstringthreadIdstring
Также доступно в
updateDraft
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.
Входные данные
draftIdstringОбязательно- Не пустое
tostring[]ccstring[]bccstring[]subjectstring- До 998 символов
htmlstring- До 1000000 символов
textstring- До 1000000 символов
fromstring- Может быть null
threadIdstring
Также доступно в
deleteDraft
Delete a draft for good. It does not go to the Bin and cannot be brought back. Take the id from listDrafts.
Входные данные
draftIdstringОбязательно- Не пустое