Class GmailMessage

reply-to 주소를 사용하여 이 메일의 발신자에게 답장하는 초안 메시지를 만듭니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft reply to the original message with an acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('Got your message');

매개변수

리턴

GmailDraft: 새로 작성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

이메일의 발신자에게 답장하는 초안 메시지를 답장 주소를 사용하여 만듭니다(인수는 선택사항).

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: 'another@example.com',
});

매개변수

고급 매개변수

리턴

GmailDraft: 새로 작성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

발신자 주소와 이 메일의 모든 수신자를 사용하여 발신자에게 답장하는 초안 메시지를 만듭니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft response to all recipients (except those bcc'd) with an
// acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('Got your message');

매개변수

리턴

GmailDraft: 새로 작성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

이메일의 발신자에게 답장하는 초안 메시지를 작성합니다(선택적 인수 사용). 이때 답장 주소와 모든 수신자를 사용합니다.

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft response to all recipients (except those bcc'd) using an HTML
// text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: 'another@example.com',
});

매개변수

고급 매개변수

리턴

GmailDraft: 새로 작성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

이 메일을 새 수신자에게 전달합니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Forward first message of first inbox thread to recipient1 & recipient2,
// both @example.com
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('recipient1@example.com,recipient2@example.com');

매개변수

리턴

GmailMessage: 체이닝에 유용한 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• forward(recipient, options)

선택적 인수와 함께 이 메일을 새 수신자에게 전달합니다.

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기(헤더 포함)는 할당량 제한이 적용됩니다.

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('recipient1@example.com,recipient2@example.com', {
  cc: 'myboss@example.com',
  bcc: 'mybosses-boss@example.com,vp@example.com',
});

매개변수

고급 매개변수

리턴

GmailMessage: 체이닝에 유용한 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• forward(recipient)

이 메시지의 모든 첨부파일을 가져옵니다.

리턴

GmailAttachment[]: 이 메시지의 Blob 첨부파일 배열입니다.

승인

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

• https://mail.google.com/

이 메시지의 모든 첨부파일을 가져옵니다.

매개변수

고급 매개변수

리턴

GmailAttachment[]: 이 메시지의 Blob 첨부파일 배열입니다.

승인

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

• https://mail.google.com/

이 메일에서 숨은참조로 추가된 수신자를 쉼표로 구분하여 가져옵니다.

정의상 수신된 모든 메시지의 경우 이 필드는 비어 있습니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getBcc());                      // Log bcc'd addresses

리턴

String: 이 메일에 숨은참조로 추가된 수신자를 쉼표로 구분하여 표시합니다.

승인

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

• https://mail.google.com/

참고 항목

• getTo()

이 메시지의 본문의 HTML 콘텐츠를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getBody());                     // Log contents of the body

리턴

String: 이 메시지의 본문 콘텐츠입니다.

승인

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

• https://mail.google.com/

참고 항목

• getSubject()

이 메일에 참조로 추가된 수신자를 쉼표로 구분하여 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getCc());                       // Log cc'd addresses

리턴

String: 이 메일에 참조로 추가된 수신자를 쉼표로 구분하여 표시합니다.

승인

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

• https://mail.google.com/

참고 항목

• getTo()

이 메시지의 날짜 및 시간을 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getDate());  // Log date and time of the message

리턴

Date: 이 메시지의 날짜 및 시간입니다.

승인

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

• https://mail.google.com/

이 메시지의 발신자를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getFrom());  // Log from address of the message

리턴

String: 메일 발신자의 이메일 주소입니다.

승인

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

• https://mail.google.com/

참고 항목

• getReplyTo()

헤더 이름을 기준으로 RFC 2822 헤더의 값을 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox.
const message = thread.getMessages()[0];           // Get the first message.
Logger.log(
    message.getHeader('Message-ID'));  // Logs the Message-ID RFC 2822 header.

매개변수

리턴

String: 헤더의 값 또는 메시지에 헤더가 없는 경우 빈 문자열입니다.

승인

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

• https://mail.google.com/

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
const id = message.getId();
const messageById = GmailApp.getMessageById(id);
Logger.log(
    message.getSubject() === messageById.getMessage());  // Always logs true

리턴

String: 메시지 ID입니다.

HTML 형식이 적용되지 않은 이 메시지의 본문 내용을 가져옵니다. 이는 getBody()보다 복잡하고 시간이 더 오래 걸립니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getPlainBody());                // Log contents of the body

리턴

String: 이 메시지의 일반 본문 콘텐츠입니다.

승인

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

• https://mail.google.com/

참고 항목

• getSubject()

이 메시지의 원시 콘텐츠를 가져옵니다. 이는 Gmail UI의 '원본 표시'와 같습니다.

리턴

String: 이 메시지의 원시 콘텐츠입니다.

승인

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

• https://mail.google.com/

이 메시지의 답장받을 주소 (일반적으로 발신자)를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getReplyTo());                  // Logs reply-to address

리턴

String: 답장할 이메일 주소입니다.

승인

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

• https://mail.google.com/

참고 항목

• getCc()

이 메시지의 제목을 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getSubject());                  // Log subject line

리턴

String: 이 메시지의 제목입니다.

승인

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

• https://mail.google.com/

참고 항목

• getAttachments()

이 메시지가 포함된 대화목록을 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(
    message.getThread().getFirstMessageSubject() ===
        thread.getFirstMessageSubject(),
);  // Always logs true

리턴

GmailThread: 이 메일이 포함된 GmailThread입니다.

승인

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

• https://mail.google.com/

이 메시지의 수신자를 쉼표로 구분하여 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getTo());  // Log the recipient of message

리턴

String: 이 메시지의 수신자를 쉼표로 구분하여 나타냅니다.

승인

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

• https://mail.google.com/

참고 항목

• getCc()

이 메시지가 초안인지 여부를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is draft? ${message.isDraft()}`);

리턴

Boolean: 이 메시지가 초안인지 여부입니다.

승인

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

• https://mail.google.com/

이 메시지가 채팅인지 여부를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is a chat? ${message.isInChats()}`);

리턴

Boolean — 이 메시지가 채팅인지 여부입니다.

이 메시지가 받은편지함에 있는지 여부를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in inbox? ${message.isInInbox()}`);

리턴

Boolean — 이 메일이 받은편지함에 있는지 여부입니다.

승인

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

• https://mail.google.com/

이 메시지가 우선순위 받은편지함에 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다.

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log(`is in priority inbox? ${messages[i].isInPriorityInbox()}`);
}

리턴

Boolean: 이 메일이 자동분류함에 있는지 여부입니다.

승인

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

• https://mail.google.com/

이 메일이 휴지통에 있는지 여부를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in the trash? ${message.isInTrash()}`);

리턴

Boolean — 이 메일이 휴지통에 있는지 여부입니다.

이 메시지에 별표표시가 되어 있는지 여부를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is starred? ${message.isStarred()}`);

리턴

Boolean: 이 메시지에 별표표시가 되어 있는지 여부입니다.

이 메시지가 읽지 않은 상태인지 여부를 가져옵니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is unread? ${message.isUnread()}`);

리턴

Boolean: 이 메시지의 읽지 않음 상태입니다.

승인

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

• https://mail.google.com/

메일을 읽음으로 표시합니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.markRead();                                // Mark as read

리턴

GmailMessage: 체이닝에 유용한 GmailMessage입니다.

승인

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

• https://mail.google.com/

참고 항목

• isUnread()

메일을 읽지 않음으로 표시합니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.markUnread();                              // Mark as unread

리턴

GmailMessage: 체이닝에 유용한 GmailMessage입니다.

승인

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

• https://mail.google.com/

참고 항목

• isUnread()

메일을 휴지통으로 이동합니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.moveToTrash();                             // Move message to trash

리턴

GmailMessage: 체이닝에 유용한 GmailMessage입니다.

승인

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

• https://mail.google.com/

참고 항목

• isInTrash()

Gmail에서 이 메시지와 연결된 상태를 새로고침합니다 (라벨, 읽음 상태 등이 변경된 경우에 유용).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
// .. Do bunch of stuff here
message.refresh();  // Make sure it's up to date
// Do more stuff to message

리턴

GmailMessage: 체이닝을 위한 메시지입니다.

승인

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

• https://mail.google.com/

답장받을 주소를 사용하여 이 메일의 발신자에게 답장합니다. 이메일 크기(헤더 포함)는 할당량 제한이 적용됩니다.

// Respond to author of message with acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.reply('Got your message');

매개변수

리턴

GmailMessage: 체이닝에 유용한 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

이 메일의 발신자에게 회신 주소를 사용하여 답장합니다(인수가 선택사항).

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기(헤더 포함)는 할당량 제한이 적용됩니다.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.reply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  noReply: true,
});

매개변수

고급 매개변수

리턴

GmailMessage: 체이닝에 유용한 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• reply(body)
• replyAll(body)
• replyAll(body, options)

답장 주소와 이 메일의 모든 수신자를 사용하여 발신자에게 답장합니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Respond to all recipients (except bcc'd) of last email in thread with
// acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('Got your message');

매개변수

리턴

GmailMessage: 연결에 유용한 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• reply(body)
• reply(body, options)
• replyAll(body, options)

선택적 인수를 사용하여 이메일의 발신자에게 답장-받는사람 주소와 모든 수신자를 사용하여 답장합니다.

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기(헤더 포함)는 할당량 제한이 적용됩니다.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  noReply: true,
});

매개변수

고급 매개변수

리턴

GmailMessage: 체이닝에 유용한 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• reply(body)
• reply(body, options)
• replyAll(body)

메일에 별표표시를 지정합니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.star();                                    // Star the message

리턴

GmailMessage: 체이닝에 유용한 GmailMessage입니다.

승인

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

• https://mail.google.com/

참고 항목

• unstar()

메시지의 별표를 삭제합니다.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.unstar();                                  // Unstar the message

리턴

GmailMessage: 체이닝에 유용한 GmailMessage입니다.

승인

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

• https://mail.google.com/

참고 항목

• star()