Class GmailDraft

GmailDraft

사용자의 Gmail 계정에 있는 사용자 생성 초안 메시지입니다.

메서드

메서드	반환 유형	간략한 설명
deleteDraft()	void	이 임시보관된 메시지를 삭제합니다.
getId()	String	이 임시 메일의 ID를 가져옵니다.
getMessage()	GmailMessage	이 초안을 나타내는 GmailMessage를 반환합니다.
getMessageId()	String	이 초안을 나타내는 GmailMessage의 ID를 반환합니다.
send()	GmailMessage	이 임시 이메일 메시지를 전송합니다.
update(recipient, subject, body)	GmailDraft	이 임시보관 메시지의 콘텐츠를 바꿉니다.
update(recipient, subject, body, options)	GmailDraft	선택적 인수를 사용하여 이 임시 메시지의 콘텐츠를 바꿉니다.

자세한 문서

deleteDraft()

이 임시보관된 메시지를 삭제합니다.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage();  // Throws exception.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

---

getId()

이 임시 메일의 ID를 가져옵니다.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const draftId = draft.getId();
const draftById = GmailApp.getDraft(draftId);
Logger.log(
    draft.getMessage().getSubject() === draftById.getMessage().getSubject(),
);

리턴

String: 초안 ID

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

---

getMessage()

이 초안을 나타내는 GmailMessage를 반환합니다.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const message = draft.getMessage();
Logger.log(message.getSubject());

리턴

GmailMessage - 이 초안의 콘텐츠를 나타내는 메시지

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

---

getMessageId()

이 초안을 나타내는 GmailMessage의 ID를 반환합니다.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const messageId = draft.getMessageId();
Logger.log(messageId === draft.getMessage().getId());

리턴

String: 메시지 ID

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

---

send()

이 임시 이메일 메시지를 전송합니다. 이메일 크기 (헤더 포함)가 할당량으로 제한됩니다.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const msg = draft.send();     // Send it
Logger.log(msg.getDate());    // Should be approximately the current timestamp

리턴

GmailMessage - 새로 전송된 메시지

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

---

update(recipient, subject, body)

이 임시보관 메시지의 콘텐츠를 바꿉니다. 이메일 크기 (헤더 포함)가 할당량으로 제한됩니다.

// The code below will update a draft email with the current date and time.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const now = new Date();
draft.update(
    '[e-mail]',
    'current time',
    `The time is: ${now.toString()}`,
);

매개변수

이름	유형	설명
recipient	String	쉼표로 구분된 이메일 주소 목록
subject	String	이메일 제목 (영문 기준 최대 250자)
body	String	이메일 본문

리턴

GmailDraft: 새로 업데이트된 초안

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• GmailApp.createDraft(recipient, subject, body)

---

update(recipient, subject, body, options)

선택적 인수를 사용하여 이 임시 메시지의 콘텐츠를 바꿉니다. 이메일에는 일반 텍스트 또는 HTML 본문이 포함될 수 있습니다. 이메일 크기 (헤더 포함)가 할당량으로 제한됩니다.

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update(
    '[e-mail]',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

매개변수

이름	유형	설명
recipient	String	쉼표로 구분된 이메일 주소 목록
subject	String	이메일 제목 (영문 기준 최대 250자)
body	String	이메일 본문
options	Object	아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체

고급 파라미터

이름	유형	설명
attachments	BlobSource[]	이메일과 함께 전송할 파일 배열
bcc	String	숨은참조할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소를 쉼표로 구분한 목록
from	String	이메일이 전송되어야 하는 주소로, GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 선택적 inlineImages 필드를 추가할 수 있습니다.
inlineImages	Object	이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 JavaScript 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조가 포함되어 있다고 가정합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
replyTo	String	기본 답신 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)

리턴

GmailDraft: 새로 업데이트된 초안

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• GmailApp.createDraft(recipient, subject, body, options)