임시보관함은 DRAFT
시스템 라벨이 적용된 보내지 않은 메일을 표시합니다.
초안에 포함된 메시지는 한 번 생성된 후에는 수정할 수 없지만 교체는 가능합니다. 이러한 의미에서 초안 리소스는 메시지가 교체될 때마다 기본 메시지 ID가 변경되므로 안정적인 ID를 제공하는 컨테이너라고 할 수 있습니다.
초안 내의 메시지 리소스는 다음과 같은 차이점을 제외하고 다른 메시지와 비슷하게 작동합니다.
- 임시보관 메일에는
DRAFT
시스템 라벨 이외의 다른 라벨이 있을 수 없습니다. - 초안이 전송되면 초안이 자동으로 삭제되고
SENT
시스템 라벨로 ID가 업데이트된 새 메시지가 생성됩니다. 이 메시지는drafts.send
응답으로 반환됩니다.
목차
임시보관 메시지 만들기
애플리케이션은 drafts.create 메서드를 사용하여 초안을 만들 수 있습니다. 일반적인 프로세스는 다음과 같습니다.
- RFC 2822를 준수하는 MIME 메시지를 작성합니다.
- 메시지를 base64url로 인코딩된 문자열로 변환합니다.
- 초안을 만들고
drafts.message.raw
필드의 값을 인코딩된 문자열로 설정합니다.
다음 코드 예는 이 프로세스를 보여줍니다.
Java
Python
초안 업데이트 중
초안을 만들 때와 마찬가지로 초안을 업데이트하려면 draft.message.raw
필드를 MIME 메시지가 포함된 base64url로 인코딩된 문자열로 설정하여 요청 본문에 Draft
리소스를 제공해야 합니다. 메시지를 업데이트할 수 없으므로 초안에 포함된 메시지는 폐기되고 업데이트 요청에 제공되는 새 MIME 메시지로 대체됩니다.
format=raw
매개변수를 사용하여 drafts.get
를 호출하여 초안에 포함된 현재 MIME 메시지를 검색할 수 있습니다.
자세한 내용은 drafts.update
를 참고하세요.
초안 전송 중
초안을 보낼 때 메시지를 있는 그대로 전송할지 또는 업데이트된 메시지로 전송할지 선택할 수 있습니다. 새 메시지로 초안 콘텐츠를 업데이트하는 경우 drafts.send
요청의 본문에 Draft
리소스를 제공합니다. 전송할 초안의 draft.id
를 설정하고 draft.message.raw
필드를 base64url로 인코딩된 문자열로 인코딩된 새 MIME 메시지로 설정합니다. 자세한 내용은 drafts.send
를 참고하세요.