이 페이지는 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()`

이 초안 메시지를 삭제합니다.

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(
    'mike@example.com',
    '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(
    'mike@example.com',
    '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`	BCC할 이메일 주소를 쉼표로 구분한 목록
`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)