사용자의 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. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReply("Got your message");
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
리턴
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" });
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
options | Object | 아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
GmailApp.getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 이 속성을 설정하면 HTML을 렌더링할 수 있는 기기가
필수 본문 인수 HTML 본문에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
subject | String | 이메일의 새로운 제목(영문 기준 최대 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");
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
리턴
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" });
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
options | Object | 아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
GmailApp.getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 이 속성을 설정하면 HTML을 렌더링할 수 있는 기기가
필수 본문 인수 HTML 본문에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
subject | String | 이메일의 새로운 제목(영문 기준 최대 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");
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 쉼표로 구분된 이메일 주소 목록입니다. |
리턴
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" });
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 쉼표로 구분된 이메일 주소 목록입니다. |
options | Object | 아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
GmailApp.getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 이 속성을 설정하면 HTML을 렌더링할 수 있는 기기가
필수 본문 인수 HTML 본문에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
noReply | Boolean | true 일반 웹 주소로 이메일을 보내야 하는 경우
수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은
Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음 |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
subject | String | 이메일의 새로운 제목(영문 기준 최대 250자)입니다. |
리턴
GmailMessage
- 이 메시지로, 연계에 유용합니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.
-
https://mail.google.com/
참고 항목
getAttachments()
이 메일의 모든 첨부파일을 가져옵니다.
리턴
GmailAttachment[]
- 이 메시지의 Blob 첨부파일 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.
-
https://mail.google.com/
getAttachments(options)
이 메일의 모든 첨부파일을 가져옵니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
options | Object | 아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
includeInlineImages | Boolean | true : 반환된 Blob의 배열
첨부파일에는 인라인 이미지가 포함되어야 합니다 (기본값은 true ). |
includeAttachments | Boolean | true : 반환된 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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 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()
이 메시지의 원시 콘텐츠를 가져옵니다. '원본 보기'와 같습니다. 사용할 수 있습니다.
리턴
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");
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
리턴
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 });
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
options | Object | 아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
GmailApp.getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 이 속성을 설정하면 HTML을 렌더링할 수 있는 기기가
필수 본문 인수 HTML 본문에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
noReply | Boolean | true 일반 웹 주소로 이메일을 보내야 하는 경우
수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은
Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음 |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
subject | String | 이메일의 새로운 제목(영문 기준 최대 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");
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
리턴
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 });
매개변수
이름 | 유형 | 설명 |
---|---|---|
body | String | 이메일의 본문입니다. |
options | Object | 아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
GmailApp.getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 이 속성을 설정하면 HTML을 렌더링할 수 있는 기기가
필수 본문 인수 HTML 본문에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
noReply | Boolean | true 일반 웹 주소로 이메일을 보내야 하는 경우
수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은
Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음 |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
subject | String | 이메일의 새로운 제목(영문 기준 최대 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/