Class GmailMessage

Gmail 메일

사용자의 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이메일의 본문입니다.

Return

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아래에 나와 있는 것처럼 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

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

Return

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이메일의 본문입니다.

Return

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아래에 나와 있는 것처럼 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

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

Return

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쉼표로 구분된 이메일 주소 목록입니다.

Return

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아래에 나와 있는 것처럼 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

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

Return

GmailMessage: 이 메시지는 체이닝에 유용합니다.

승인

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

  • https://mail.google.com/

참고 항목


getAttachments()

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

Return

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

승인

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

  • https://mail.google.com/

getAttachments(options)

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

매개변수

이름유형설명
optionsObject아래에 나와 있는 것처럼 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름유형설명
includeInlineImagesBooleantrue: 반환된 Blob 첨부파일 배열에 인라인 이미지가 포함되어야 합니다 (기본값: true).
includeAttachmentsBooleantrue: 반환된 Blob 첨부파일 배열에 일반 (비 인라인) 첨부파일이 포함되어야 하는 경우 (기본값: true).

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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.

매개변수

이름유형설명
nameString값과 구분되는 콜론이 없는 RFC 헤더 이름입니다.

Return

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

Return

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

Return

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

승인

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

  • https://mail.google.com/

참고 항목


getRawContent()

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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

Return

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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

Return

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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

Return

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이메일의 본문입니다.

Return

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아래에 나와 있는 것처럼 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

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

Return

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이메일의 본문입니다.

Return

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아래에 나와 있는 것처럼 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

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

Return

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

Return

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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

Return

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

승인

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

  • https://mail.google.com/

참고 항목