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()	String	HTML 형식이 없는 이 메시지의 본문 내용을 가져옵니다.
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()	GmailMessage	Gmail에서 이 메시지와 연결된 상태를 다시 로드합니다 (라벨, 읽음 상태 등이 변경된 경우 유용함).
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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('Got your message');

매개변수

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

리턴

GmailDraft - 새로 생성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

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

---

createDraftReply(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: '[e-mail]',
});

매개변수

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

고급 파라미터

이름	유형	설명
attachments	BlobSource[]	이메일과 함께 전송할 파일 배열
bcc	String	숨은참조할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소를 쉼표로 구분한 목록
from	String	이메일이 전송되어야 하는 주소로, GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 선택적 inlineImages 필드를 추가할 수 있습니다.
inlineImages	Object	이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 JavaScript 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조가 포함되어 있다고 가정합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
replyTo	String	기본 답신 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subject	String	이메일의 새 제목입니다. 최대 250자(영문 기준)까지 가능합니다.

리턴

GmailDraft - 새로 생성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

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

---

createDraftReplyAll(body)

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

// 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');

매개변수

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

리턴

GmailDraft - 새로 생성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(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: '[e-mail]',
});

매개변수

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

고급 파라미터

이름	유형	설명
attachments	BlobSource[]	이메일과 함께 전송할 파일 배열
bcc	String	숨은참조할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소를 쉼표로 구분한 목록
from	String	이메일이 전송되어야 하는 주소로, GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 선택적 inlineImages 필드를 추가할 수 있습니다.
inlineImages	Object	이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 JavaScript 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조가 포함되어 있다고 가정합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
replyTo	String	기본 답신 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subject	String	이메일의 새 제목입니다. 최대 250자(영문 기준)까지 가능합니다.

리턴

GmailDraft - 새로 생성된 초안 메시지입니다.

승인

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

• https://mail.google.com/

참고 항목

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

---

forward(recipient)

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

// 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('[e-mail],[e-mail]');

매개변수

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

리턴

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

승인

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

• https://mail.google.com/

참고 항목

• forward(recipient, options)

---

forward(recipient, options)

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

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('[e-mail],[e-mail]', {
  cc: '[e-mail]',
  bcc: '[e-mail],[e-mail]',
});

매개변수

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

고급 파라미터

이름	유형	설명
attachments	BlobSource[]	이메일과 함께 전송할 파일 배열
bcc	String	숨은참조할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소를 쉼표로 구분한 목록
from	String	이메일이 전송되어야 하는 주소로, GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 선택적 inlineImages 필드를 추가할 수 있습니다.
inlineImages	Object	이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 JavaScript 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조가 포함되어 있다고 가정합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
noReply	Boolean	true 수신자가 이메일에 응답하지 않도록 일반적인 회신 불가 이메일 주소에서 이메일을 보내야 하는 경우. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 가능합니다.
replyTo	String	기본 답신 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subject	String	이메일의 새 제목입니다. 최대 250자(영문 기준)까지 가능합니다.

리턴

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

승인

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

• https://mail.google.com/

참고 항목

• forward(recipient)

---

getAttachments()

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

리턴

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

승인

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

• https://mail.google.com/

---

getAttachments(options)

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

매개변수

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

고급 파라미터

이름	유형	설명
includeInlineImages	Boolean	반환된 Blob 첨부파일 배열에 인라인 이미지를 포함해야 하는 경우 (기본값은 true) true입니다.
includeAttachments	Boolean	반환된 Blob 첨부파일 배열에 일반 (인라인이 아닌) 첨부파일을 포함해야 하는 경우 true (기본값은 true)

리턴

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

승인

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

• https://mail.google.com/

---

getBcc()

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

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

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

---

getBody()

이 메시지의 본문의 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()

---

getCc()

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

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

---

getDate()

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

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/

---

getFrom()

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

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

---

getHeader(name)

헤더 이름이 지정된 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.

매개변수

이름	유형	설명
name	String	RFC 헤더의 이름입니다. 값과 구분하는 콜론은 제외됩니다.

리턴

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

승인

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

• https://mail.google.com/

---

getId()

이 메시지의 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입니다.

---

getPlainBody()

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

---

getRawContent()

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

리턴

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

승인

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

• https://mail.google.com/

---

getReplyTo()

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

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

---

getSubject()

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

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

---

getThread()

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

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 - 이 메일을 포함하는 Gmail 스레드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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.getTo());  // Log the recipient of message

리턴

String: 이 메시지의 수신자(쉼표로 구분)

승인

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

• https://mail.google.com/

참고 항목

• getCc()

---

isDraft()

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

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/

---

isInChats()

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

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 - 이 메시지가 채팅인지 여부입니다.

---

isInInbox()

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

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/

---

isInPriorityInbox()

이 메시지가 우선순위 받은편지함에 있으면 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/

---

isInTrash()

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

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 — 이 메일이 휴지통에 있는지 여부입니다.

---

isStarred()

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

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 - 이 메시지에 별표가 표시되어 있는지 여부입니다.

---

isUnread()

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

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/

---

markRead()

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

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

---

markUnread()

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

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

---

moveToTrash()

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

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

---

refresh()

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/

---

reply(body)

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

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

매개변수

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

리턴

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

승인

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

• https://mail.google.com/

참고 항목

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

---

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

매개변수

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

고급 파라미터

이름	유형	설명
attachments	BlobSource[]	이메일과 함께 전송할 파일 배열
bcc	String	숨은참조할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소를 쉼표로 구분한 목록
from	String	이메일이 전송되어야 하는 주소로, GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 선택적 inlineImages 필드를 추가할 수 있습니다.
inlineImages	Object	이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 JavaScript 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조가 포함되어 있다고 가정합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
noReply	Boolean	true 수신자가 이메일에 응답하지 않도록 일반적인 회신 불가 이메일 주소에서 이메일을 보내야 하는 경우. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 가능합니다.
replyTo	String	기본 답신 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subject	String	이메일의 새 제목입니다. 최대 250자(영문 기준)까지 가능합니다.

리턴

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

승인

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

• https://mail.google.com/

참고 항목

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

---

replyAll(body)

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

// 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');

매개변수

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

리턴

GmailMessage - 이 메시지(연결에 유용)

승인

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

• https://mail.google.com/

참고 항목

• reply(body)
• reply(body, options)
• replyAll(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,
});

매개변수

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

고급 파라미터

이름	유형	설명
attachments	BlobSource[]	이메일과 함께 전송할 파일 배열
bcc	String	숨은참조할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소를 쉼표로 구분한 목록
from	String	이메일이 전송되어야 하는 주소로, GmailApp.getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 선택적 inlineImages 필드를 추가할 수 있습니다.
inlineImages	Object	이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 JavaScript 객체입니다. htmlBody 매개변수가 사용되고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조가 포함되어 있다고 가정합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
noReply	Boolean	true 수신자가 이메일에 응답하지 않도록 일반적인 회신 불가 이메일 주소에서 이메일을 보내야 하는 경우. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 가능합니다.
replyTo	String	기본 답신 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)
subject	String	이메일의 새 제목입니다. 최대 250자(영문 기준)까지 가능합니다.

리턴

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

승인

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

• https://mail.google.com/

참고 항목

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

---

star()

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

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

---

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