Class GmailMessage

GmailMessage

사용자의 Gmail 계정에 있는 메일입니다.

방법

메서드반환 유형간략한 설명
createDraftReply(body)GmailDraft답장 주소를 사용하여 이 메일의 발신자에게 답장하는 임시보관 메일을 만듭니다.
createDraftReply(body, options)GmailDraft답장 주소와 선택적 인수를 사용하여 이 메시지의 발신자에게 답장하는 임시보관 메시지를 만듭니다.
createDraftReplyAll(body)GmailDraft답장 주소와 이 메시지의 모든 수신자를 사용하여 발신자에게 보내는 임시보관 메시지를 만듭니다.
createDraftReplyAll(body, options)GmailDraft답장 주소 및 모든 수신자와 선택적 인수를 사용하여 이 메시지의 발신자에게 답장하는 임시보관 메시지를 만듭니다.
forward(recipient)GmailMessage이 메일을 새 수신자에게 전달합니다.
forward(recipient, options)GmailMessage선택적 인수를 사용하여 이 메일을 새 수신자에게 전달합니다.
getAttachments()GmailAttachment[]이 메일의 모든 첨부파일을 가져옵니다.
getAttachments(options)GmailAttachment[]이 메일의 모든 첨부파일을 가져옵니다.
getBcc()String이 메일에 숨은참조로 지정된 쉼표로 구분된 수신자를 가져옵니다.
getBody()String이 메시지 본문의 HTML 콘텐츠를 가져옵니다.
getCc()String이 메일에 참조된 쉼표로 구분된 수신자를 가져옵니다.
getDate()Date이 메시지의 날짜와 시간을 가져옵니다.
getFrom()String이 메시지의 발신자를 가져옵니다.
getHeader(name)String헤더 이름이 지정된 RFC 2822 헤더의 값을 가져옵니다.
getId()String이 메시지의 ID를 가져옵니다.
getPlainBody()StringHTML 형식 없이 메시지 본문의 콘텐츠를 가져옵니다.
getRawContent()String이 메시지의 원시 콘텐츠를 가져옵니다.
getReplyTo()String이 메일의 답장 주소 (일반적으로 발신자)를 가져옵니다.
getSubject()String이 메시지의 제목을 가져옵니다.
getThread()GmailThread이 메시지가 포함된 스레드를 가져옵니다.
getTo()String이 메시지의 쉼표로 구분된 수신자를 가져옵니다.
isDraft()Boolean이 메시지의 임시보관 메시지인지 여부를 가져옵니다.
isInChats()Boolean이 메시지가 채팅인지 여부를 가져옵니다.
isInInbox()Boolean이 메일이 받은편지함에 있는지 여부를 확인합니다.
isInPriorityInbox()Boolean이 메시지가 중요 받은편지함에 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다.
isInTrash()Boolean메일이 휴지통에 있는지 여부를 확인합니다.
isStarred()Boolean이 메시지에 별표 표시 여부를 가져옵니다.
isUnread()Boolean이 메시지의 읽지않음 여부를 확인합니다.
markRead()GmailMessage메일을 읽음으로 표시합니다.
markUnread()GmailMessage메일을 읽지않음으로 표시합니다.
moveToTrash()GmailMessage메일을 휴지통으로 이동합니다.
refresh()GmailMessageGmail에서 이 메시지와 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
reply(body)GmailMessage답장받을 주소를 사용하여 이 메일의 발신자에게 답장을 보냅니다.
reply(body, options)GmailMessage선택적 인수를 사용하여 답장받을 주소를 사용하여 이 메일의 발신자에게 답장을 보냅니다.
replyAll(body)GmailMessage답장받을 주소와 이 메일의 모든 수신자를 사용하여 발신자에게 답장합니다.
replyAll(body, options)GmailMessage답장 주소 및 모든 수신자와 함께 선택적 인수를 사용하여 이 메시지의 발신자에게 답장합니다.
star()GmailMessage메일에 별표표시합니다.
unstar()GmailMessage메시지의 별표를 삭제합니다.

자세한 문서

createDraftReply(body)

답장 주소를 사용하여 이 메일의 발신자에게 답장하는 임시보관 메일을 만듭니다. 헤더를 포함한 이메일 크기는 할당량이 제한됩니다.

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

매개변수

이름유형설명
bodyString이메일 본문입니다.

리턴

GmailDraft - 새로 생성된 임시보관 메시지입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


createDraftReply(body, options)

답장 주소와 선택적 인수를 사용하여 이 메시지의 발신자에게 답장하는 임시보관 메시지를 만듭니다.

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.
optionsObject아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 보낼 파일의 배열
bccString숨은참조에 쉼표로 구분된 이메일 주소 목록
ccString참조에 넣을 이메일 주소 쉼표로 구분된 목록
fromString이메일을 보낼 때 사용할 주소이며 GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정되면 HTML을 렌더링할 수 있는 기기에서는 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드(선택사항)를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 자바스크립트 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식의 이미지 참조가 포함된다고 가정합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
replyToString기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subjectString최대 250자(영문 기준)의 새 이메일 제목

리턴

GmailDraft - 새로 생성된 임시보관 메시지입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


createDraftReplyAll(body)

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.

리턴

GmailDraft - 새로 생성된 임시보관 메시지입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


createDraftReplyAll(body, options)

답장 주소 및 모든 수신자와 선택적 인수를 사용하여 이 메시지의 발신자에게 답장하는 임시보관 메시지를 만듭니다.

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.
optionsObject아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 보낼 파일의 배열
bccString숨은참조에 쉼표로 구분된 이메일 주소 목록
ccString참조에 넣을 이메일 주소 쉼표로 구분된 목록
fromString이메일을 보낼 때 사용할 주소이며 GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정되면 HTML을 렌더링할 수 있는 기기에서는 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드(선택사항)를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 자바스크립트 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식의 이미지 참조가 포함된다고 가정합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
replyToString기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subjectString최대 250자(영문 기준)의 새 이메일 제목

리턴

GmailDraft - 새로 생성된 임시보관 메시지입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


forward(recipient)

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

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

매개변수

이름유형설명
recipientString쉼표로 구분된 이메일 주소 목록입니다.

리턴

GmailMessage - 이 메시지로, 연결하는 데 유용합니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


forward(recipient, options)

선택적 인수를 사용하여 이 메일을 새 수신자에게 전달합니다.

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

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

매개변수

이름유형설명
recipientString쉼표로 구분된 이메일 주소 목록입니다.
optionsObject아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 보낼 파일의 배열
bccString숨은참조에 쉼표로 구분된 이메일 주소 목록
ccString참조에 넣을 이메일 주소 쉼표로 구분된 목록
fromString이메일을 보낼 때 사용할 주소이며 GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정되면 HTML을 렌더링할 수 있는 기기에서는 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드(선택사항)를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 자바스크립트 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식의 이미지 참조가 포함된다고 가정합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBoolean수신자가 이메일에 응답하지 못하도록 일반 회신 없는 이메일 주소에서 이메일을 보내야 하는 경우 true. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 사용할 수 있습니다.
replyToString기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subjectString최대 250자(영문 기준)의 새 이메일 제목

리턴

GmailMessage - 이 메시지로, 연결하는 데 유용합니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getAttachments()

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

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

getAttachments(options)

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

매개변수

이름유형설명
optionsObject아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
includeInlineImagesBoolean반환된 Blob 연결의 배열에 인라인 이미지가 포함되어야 하는 경우 true입니다 (기본값은 true).
includeAttachmentsBoolean반환된 Blob 연결의 배열에 일반 (비인라인) 연결을 포함해야 하는 경우 true입니다 (기본값은 true).

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

getBcc()

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

정의된 모든 수신 메시지에 대해 비어 있습니다.

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

리턴

String — 이 메일에 숨은참조로 추가된 쉼표로 구분된 수신자입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getBody()

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

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

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getCc()

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

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

리턴

String — 이 메일에 참조로 포함된 쉼표로 구분된 수신자입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getDate()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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/

getFrom()

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

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

리턴

String - 메시지 발신자의 이메일 주소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getHeader(name)

헤더 이름이 지정된 RFC 2822 헤더의 값을 가져옵니다.

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

매개변수

이름유형설명
nameStringRFC 헤더의 이름으로, 값과 콜론을 구분하지 않습니다.

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

getId()

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

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

리턴

String - 메시지 ID입니다.


getPlainBody()

HTML 형식 없이 메시지 본문의 콘텐츠를 가져옵니다. 이는 getBody()보다 더 복잡하며 시간이 더 오래 걸립니다.

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

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getRawContent()

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

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

getReplyTo()

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

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

리턴

String - 답장을 받을 이메일 주소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getSubject()

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

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

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


getThread()

이 메시지가 포함된 스레드를 가져옵니다.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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/

getTo()

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

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

리턴

String - 이 메시지의 쉼표로 구분된 수신자.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


isDraft()

이 메시지의 임시보관 메시지인지 여부를 가져옵니다.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

리턴

Boolean - 메시지가 임시보관 메시지인지 여부입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

isInChats()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

리턴

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


isInInbox()

이 메일이 받은편지함에 있는지 여부를 확인합니다.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

isInPriorityInbox()

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

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var 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/

isInTrash()

메일이 휴지통에 있는지 여부를 확인합니다.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

리턴

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


isStarred()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

리턴

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


isUnread()

이 메시지의 읽지않음 여부를 확인합니다.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

리턴

Boolean — 이 메시지의 읽지 않은 상태입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

markRead()

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

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

리턴

GmailMessage - 연결하는 데 유용한 GmailMessage입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


markUnread()

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

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

리턴

GmailMessage - 연결하는 데 유용한 GmailMessage입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


moveToTrash()

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

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

리턴

GmailMessage - 연결하는 데 유용한 GmailMessage입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


refresh()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var 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/

reply(body)

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.

리턴

GmailMessage - 이 메시지로, 연결하는 데 유용합니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


reply(body, options)

선택적 인수를 사용하여 답장받을 주소를 사용하여 이 메일의 발신자에게 답장을 보냅니다.

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.
optionsObject아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 보낼 파일의 배열
bccString숨은참조에 쉼표로 구분된 이메일 주소 목록
ccString참조에 넣을 이메일 주소 쉼표로 구분된 목록
fromString이메일을 보낼 때 사용할 주소이며 GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정되면 HTML을 렌더링할 수 있는 기기에서는 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드(선택사항)를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 자바스크립트 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식의 이미지 참조가 포함된다고 가정합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBoolean수신자가 이메일에 응답하지 못하도록 일반 회신 없는 이메일 주소에서 이메일을 보내야 하는 경우 true. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 사용할 수 있습니다.
replyToString기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subjectString최대 250자(영문 기준)의 새 이메일 제목

리턴

GmailMessage - 이 메시지로, 연결하는 데 유용합니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


replyAll(body)

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.

리턴

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


replyAll(body, options)

답장 주소 및 모든 수신자와 함께 선택적 인수를 사용하여 이 메시지의 발신자에게 답장합니다.

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

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

매개변수

이름유형설명
bodyString이메일 본문입니다.
optionsObject아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 보낼 파일의 배열
bccString숨은참조에 쉼표로 구분된 이메일 주소 목록
ccString참조에 넣을 이메일 주소 쉼표로 구분된 목록
fromString이메일을 보낼 때 사용할 주소이며 GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정되면 HTML을 렌더링할 수 있는 기기에서는 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드(선택사항)를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 자바스크립트 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식의 이미지 참조가 포함된다고 가정합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBoolean수신자가 이메일에 응답하지 못하도록 일반 회신 없는 이메일 주소에서 이메일을 보내야 하는 경우 true. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 사용할 수 있습니다.
replyToString기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subjectString최대 250자(영문 기준)의 새 이메일 제목

리턴

GmailMessage - 이 메시지로, 연결하는 데 유용합니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


star()

메일에 별표표시합니다.

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

리턴

GmailMessage - 연결하는 데 유용한 GmailMessage입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목


unstar()

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

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

리턴

GmailMessage - 연결하는 데 유용한 GmailMessage입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

  • https://mail.google.com/

참고 항목