임시 보관함
메일함에 저장된, 아직 보내지 않은 메시지.
초안 도구
| 도구 | 하는 일 |
|---|---|
| listDrafts | 초안 목록을 최근 저장된 순으로 보여 주며, 각각 제목, 수신자, 발신자를 담습니다. query로 검색합니다. |
| getDraft | 초안 하나의 전부: 발신자, 수신자, 제목, 답장 대상 스레드, 첨부 파일, 본문. |
| createDraft | 새 초안을 보내지 않고 저장합니다. 모든 필드는 선택 사항이며, threadId를 주면 답장이 됩니다. |
| updateDraft | 초안의 필드를 바꿉니다. 빼놓은 필드는 값이 그대로 유지되고, 목록은 저장된 목록을 통째로 대체합니다. |
| deleteDraft | 초안을 영구히 삭제합니다. 휴지통으로 가지 않습니다. |
읽기에는 “임시 저장 메일 읽기”(drafts:read), 저장, 변경, 삭제에는 “임시 저장 메일 만들기 및 편집”(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필수- 비어 있지 않음