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이미지 키의 매핑을 포함하는 JavaScript 객체 (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이미지 키의 매핑을 포함하는 JavaScript 객체 (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이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBooleantrue 일반 웹 주소로 이메일을 보내야 하는 경우 수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은 Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음
replyToString기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소)
subjectString이메일의 새로운 제목(영문 기준 최대 250자)입니다.

리턴

GmailMessage - 이 메시지로, 연계에 유용합니다.

승인

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

  • https://mail.google.com/

참고 항목


getAttachments()

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

리턴

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

승인

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

  • https://mail.google.com/

getAttachments(options)

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

매개변수

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

고급 매개변수

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

매개변수

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

이 메시지의 원시 콘텐츠를 가져옵니다. '원본 보기'와 같습니다. 사용할 수 있습니다.

리턴

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이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBooleantrue 일반 웹 주소로 이메일을 보내야 하는 경우 수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은 Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음
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이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBooleantrue 일반 웹 주소로 이메일을 보내야 하는 경우 수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은 Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음
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/

참고 항목