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

리턴

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이메일의 새로운 제목(최대 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아래 나열된 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름유형설명
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아래 나열된 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름유형설명
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아래 나열된 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름유형설명
includeInlineImagesBooleantrue: 반환된 Blob 첨부파일 배열에 인라인 이미지가 포함되어야 합니다 (기본값: true).
includeAttachmentsBooleantrue: 반환된 Blob 첨부파일 배열에 일반 (인라인 아님) 연결이 포함되어야 합니다 (기본값: 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.

매개변수

이름유형설명
nameString값과 세미콜론을 구분하지 않는 RFC 헤더 이름입니다.

리턴

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

고급 매개변수

이름유형설명
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아래 나열된 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름유형설명
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/

참고 항목