이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class 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("[email protected]", "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.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update('[email protected]', '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을 대신 사용합니다. 필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 `inlineImages` 필드를 추가할 수 있습니다. 이메일에 인라인 이미지가 있는 경우 본문
`inlineImages`	`Object`	이미지 키의 매핑을 포함하는 JavaScript 객체 (`String`)를 이미지 데이터 (`BlobSource`)로 여기서는 `htmlBody` 매개변수가 사용된다고 가정하고 `<img src="cid:imageKey" />` 형식으로 이러한 이미지에 대한 참조를 포함합니다.
`name`	`String`	이메일 발신자의 이름 (기본값: 사용자 이름)
`replyTo`	`String`	기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소)

리턴

GmailDraft: 새로 업데이트된 초안

승인

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

https://mail.google.com/

참고 항목

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