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()

이 임시보관 메일을 삭제합니다.

var 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를 가져옵니다.

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

리턴

String: 초안 ID

승인

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

  • https://mail.google.com/

getMessage()

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

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

리턴

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

승인

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

  • https://mail.google.com/

getMessageId()

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

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

리턴

String: 메시지 ID

승인

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

  • https://mail.google.com/

send()

이 임시보관 이메일 메시지를 전송합니다. 헤더를 포함한 이메일의 크기는 할당량으로 제한되어 있습니다.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var 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.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

매개변수

이름유형설명
recipientString쉼표로 구분된 이메일 주소 목록
subjectString이메일 제목 (영문 기준 최대 250자)
bodyString이메일 본문입니다.

리턴

GmailDraft: 새로 업데이트된 초안

승인

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

  • https://mail.google.com/

참고 항목


update(recipient, subject, body, options)

선택적 인수를 사용하여 이 초안 메시지의 내용을 바꿉니다. 이메일에는 일반 텍스트 또는 HTML 본문입니다. 헤더를 포함한 이메일의 크기는 할당량으로 제한되어 있습니다.

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

매개변수

이름유형설명
recipientString쉼표로 구분된 이메일 주소 목록
subjectString이메일 제목 (영문 기준 최대 250자)
bodyString이메일 본문입니다.
optionsObject아래 나열된 고급 매개변수를 지정하는 JavaScript 객체

고급 매개변수

이름유형설명
attachmentsBlobSource[]- 이메일로 보낼 파일의 배열
bccString숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록
ccString참조로 추가할 이메일 주소의 쉼표로 구분된 목록
fromString이메일이 전송되어야 하는 주소이며 GmailApp.getAliases()에서 반환한 값의 백분율
htmlBodyString설정된 경우 HTML을 렌더링할 수 있는 기기에서 HTML을 대신 사용합니다. 필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 inlineImages 필드를 추가할 수 있습니다. 이메일에 인라인 이미지가 있는 경우 본문
inlineImagesObject이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
replyToString기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소)

리턴

GmailDraft: 새로 업데이트된 초안

승인

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

  • https://mail.google.com/

참고 항목