Class GmailApp

GmailApp

Gmail 대화목록, 메일, 라벨에 대한 액세스를 제공합니다.

메서드

메서드	반환 유형	간략한 설명
createDraft(recipient, subject, body)	GmailDraft	이메일 메시지 초안을 만듭니다.
createDraft(recipient, subject, body, options)	GmailDraft	선택적 인수를 사용하여 이메일 메시지 초안을 만듭니다.
createLabel(name)	GmailLabel	지정된 이름의 새 사용자 라벨을 만듭니다.
deleteLabel(label)	GmailApp	지정된 라벨을 삭제합니다.
getAliases()	String[]	Gmail에서 이 계정의 별칭으로 설정된 이메일 목록을 가져옵니다.
getDraft(draftId)	GmailDraft	ID로 이메일 메시지 초안을 가져옵니다.
getDraftMessages()	GmailMessage[]	모든 초안 메시지를 검색합니다.
getDrafts()	GmailDraft[]	모든 Gmail 임시보관 메일을 가져옵니다.
getInboxThreads()	GmailThread[]	라벨에 관계없이 모든 받은편지함 대화목록을 검색합니다.
getInboxThreads(start, max)	GmailThread[]	라벨에 관계없이 다양한 받은편지함 대화목록을 검색합니다.
getInboxUnreadCount()	Integer	받은편지함에서 읽지 않은 대화목록 수를 가져옵니다.
getMessageById(id)	GmailMessage	ID로 메시지를 가져옵니다.
getMessagesForThread(thread)	GmailMessage[]	지정된 스레드의 모든 메시지를 검색합니다.
getMessagesForThreads(threads)	GmailMessage[][]	지정된 스레드의 모든 메시지를 검색합니다.
getPriorityInboxThreads()	GmailThread[]	라벨에 관계없이 모든 자동분류함 대화목록을 검색합니다.
getPriorityInboxThreads(start, max)	GmailThread[]	라벨과 관계없이 다양한 자동분류함 대화목록을 검색합니다.
getPriorityInboxUnreadCount()	Integer	자동분류함의 읽지 않은 대화목록 수를 가져옵니다.
getSpamThreads()	GmailThread[]	라벨과 관계없이 모든 스팸 스레드를 검색합니다.
getSpamThreads(start, max)	GmailThread[]	라벨과 관계없이 다양한 스팸 스레드를 검색합니다.
getSpamUnreadCount()	Integer	읽지 않은 스팸 대화목록의 수를 가져옵니다.
getStarredThreads()	GmailThread[]	라벨과 관계없이 별표표시된 모든 스레드를 검색합니다.
getStarredThreads(start, max)	GmailThread[]	라벨과 관계없이 별표표시된 여러 스레드를 검색합니다.
getStarredUnreadCount()	Integer	별표표시된 읽지 않은 대화목록 수를 가져옵니다.
getThreadById(id)	GmailThread	ID별로 스레드를 가져옵니다.
getTrashThreads()	GmailThread[]	라벨과 관계없이 모든 휴지통 스레드를 검색합니다.
getTrashThreads(start, max)	GmailThread[]	라벨과 관계없이 다양한 휴지통 스레드를 검색합니다.
getUserLabelByName(name)	GmailLabel	라벨 이름이 지정된 라벨을 검색합니다.
getUserLabels()	GmailLabel[]	사용자가 만든 라벨 목록을 검색합니다.
markMessageRead(message)	GmailApp	이 메일을 읽음으로 표시하고 메일을 강제로 새로고침합니다.
markMessageUnread(message)	GmailApp	메일을 읽지않음으로 표시하고 강제로 새로고침합니다.
markMessagesRead(messages)	GmailApp	메일을 읽음으로 표시하고 강제로 새로고침합니다.
markMessagesUnread(messages)	GmailApp	메일을 읽지 않음으로 표시하고 강제로 새로고침합니다.
markThreadImportant(thread)	GmailApp	이 대화목록을 중요한 메일로 표시하고 스레드를 강제로 새로고침합니다.
markThreadRead(thread)	GmailApp	이 스레드를 읽음으로 표시하고 스레드를 강제로 새로고침합니다.
markThreadUnimportant(thread)	GmailApp	이 스레드를 중요하지 않은 것으로 표시하고 스레드를 강제로 새로고침합니다.
markThreadUnread(thread)	GmailApp	이 대화목록을 읽지 않음으로 표시하고 강제로 대화목록을 새로고침합니다.
markThreadsImportant(threads)	GmailApp	이러한 스레드를 중요한 것으로 표시하고 스레드를 강제로 새로고침합니다.
markThreadsRead(threads)	GmailApp	이러한 스레드를 읽음으로 표시하고 스레드를 강제로 새로고침합니다.
markThreadsUnimportant(threads)	GmailApp	이러한 스레드를 중요하지 않은 것으로 표시하고 스레드를 강제로 새로고침합니다.
markThreadsUnread(threads)	GmailApp	이러한 대화목록을 읽지 않음으로 표시하고 스레드를 강제로 새로고침합니다.
moveMessageToTrash(message)	GmailApp	메일을 휴지통으로 이동하고 강제로 메일을 새로고침합니다.
moveMessagesToTrash(messages)	GmailApp	지정된 메일을 휴지통으로 이동하고 강제로 메일을 새로고침합니다.
moveThreadToArchive(thread)	GmailApp	이 대화목록을 자료실로 이동하고 강제로 대화목록을 새로고침합니다.
moveThreadToInbox(thread)	GmailApp	이 대화목록을 받은편지함으로 이동하고 강제로 대화목록을 새로고침합니다.
moveThreadToSpam(thread)	GmailApp	이 대화목록을 스팸으로 이동하고 강제로 새로고침합니다.
moveThreadToTrash(thread)	GmailApp	이 대화목록을 휴지통으로 이동하고 강제로 대화목록을 새로고침합니다.
moveThreadsToArchive(threads)	GmailApp	이러한 대화목록을 보관 파일로 이동하고 대화목록을 강제로 새로고침합니다.
moveThreadsToInbox(threads)	GmailApp	대화목록을 받은편지함으로 이동하고 대화목록을 강제로 새로고침합니다.
moveThreadsToSpam(threads)	GmailApp	이러한 대화목록을 스팸으로 이동하고 대화목록을 강제로 새로고침합니다.
moveThreadsToTrash(threads)	GmailApp	스레드를 휴지통으로 이동하고 스레드를 강제로 새로고침합니다.
refreshMessage(message)	GmailApp	Gmail에서 메일 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).
refreshMessages(messages)	GmailApp	Gmail에서 메일 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).
refreshThread(thread)	GmailApp	Gmail에서 대화목록 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).
refreshThreads(threads)	GmailApp	Gmail에서 스레드 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).
search(query)	GmailThread[]	지정된 검색어로 Gmail을 검색합니다.
search(query, start, max)	GmailThread[]	지정된 검색어로 Gmail을 검색합니다.
sendEmail(recipient, subject, body)	GmailApp	이메일 메시지를 보냅니다.
sendEmail(recipient, subject, body, options)	GmailApp	선택적 인수를 사용하여 이메일 메시지를 보냅니다.
setCurrentMessageAccessToken(accessToken)	void	현재 메시지 설정 스크립트가 현재 GmailMessage 속성에 액세스할 수 있도록 하는 액세스 토큰입니다.
starMessage(message)	GmailApp	메일에 별표를 추가하고 메일을 강제로 새로고침합니다.
starMessages(messages)	GmailApp	메일에 별표를 추가하고 메일을 강제로 새로고침합니다.
unstarMessage(message)	GmailApp	이 메일에서 별표를 삭제하고 메일을 강제로 새로고침합니다.
unstarMessages(messages)	GmailApp	이러한 메일에서 별표를 삭제하고 메일을 강제로 새로고침합니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
getChatThreads()	GmailThread[]	Google에서 모두 전환할 때까지 모든 기존 Google 행아웃 대화목록과 Google Chat 대화목록을 가져옵니다. 기존 행아웃 사용자를 올해 말에 Chat으로 이전할 수 있습니다.
getChatThreads(start, max)	GmailThread[]	Google이 전환될 때까지 다양한 기존 Google 행아웃 대화목록과 Google Chat 대화목록을 가져옵니다. 기존 행아웃의 모든 사용자를 Chat으로 이전할 수 있습니다.

자세한 문서

createDraft(recipient, subject, body)

이메일 메시지 초안을 만듭니다. 헤더를 포함한 이메일의 크기는 할당량으로 제한되어 있습니다.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("[e-mail]", "current time", "The time is: " + now.toString());

매개변수

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

리턴

GmailDraft: 새로 생성된 GmailDraft

승인

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

• https://mail.google.com/

참고 항목

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

선택적 인수를 사용하여 이메일 메시지 초안을 만듭니다. 이메일에는 일반 텍스트 또는 HTML 본문입니다. 이메일의 크기 (헤더 포함, 첨부파일 제외)는 할당량이 제한됩니다.

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('[e-mail]', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

매개변수

이름	유형	설명
recipient	String	수신자의 주소
subject	String	제목
body	String	이메일의 본문입니다.
options	Object	아래 나열된 고급 매개변수를 지정하는 JavaScript 객체

고급 매개변수

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

리턴

GmailDraft: 새로 생성된 GmailDraft

승인

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

• https://mail.google.com/

참고 항목

• createDraft(recipient, subject, body)

---

createLabel(name)

지정된 이름의 새 사용자 라벨을 만듭니다.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

매개변수

이름	유형	설명
name	String	새 라벨의 이름

리턴

GmailLabel: 새로 생성된 라벨

승인

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

• https://mail.google.com/

참고 항목

• deleteLabel(label)

---

deleteLabel(label)

지정된 라벨을 삭제합니다.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

매개변수

이름	유형	설명
label	GmailLabel	삭제할 라벨

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• createLabel(name)

---

getAliases()

Gmail에서 이 계정의 별칭으로 설정된 이메일 목록을 가져옵니다.

'보낸사람'을 사용하여 이러한 별칭에서 메일을 보낼 수 있습니다. 선택적 인수입니다.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

리턴

String[] - 이 계정의 별칭 배열

승인

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

• https://mail.google.com/

참고 항목

• sendEmail(recipient, subject, body, options)

---

getDraft(draftId)

ID로 이메일 메시지 초안을 가져옵니다.

Gmail 임시보관함의 getId() 와 함께 사용합니다.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

매개변수

이름	유형	설명
draftId	String	가져올 초안의 ID

리턴

GmailDraft: 지정된 ID의 초안

생성 값

Error: 지정된 ID의 초안을 찾을 수 없는 경우

승인

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

• https://mail.google.com/

---

getDraftMessages()

모든 초안 메시지를 검색합니다.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

리턴

GmailMessage[] - Gmail 임시보관 메일 배열

승인

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

• https://mail.google.com/

---

getDrafts()

모든 Gmail 임시보관 메일을 가져옵니다.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

리턴

GmailDraft[] - Gmail 임시보관 메일의 배열

승인

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

• https://mail.google.com/

---

getInboxThreads()

라벨에 관계없이 모든 받은편지함 대화목록을 검색합니다.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 대화목록 크기를 알 수 없으며 매우 클 수 있는 경우 '페이징됨' 호출 각 호출에서 검색할 스레드의 범위를 지정합니다.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

리턴

GmailThread[] - 받은편지함의 Gmail 대화목록 배열

승인

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

• https://mail.google.com/

---

getInboxThreads(start, max)

라벨에 관계없이 다양한 받은편지함 대화목록을 검색합니다.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

매개변수

이름	유형	설명
start	Integer	검색할 첫 번째 스레드의 색인
max	Integer	검색할 최대 스레드 수

리턴

GmailThread[] - 받은편지함의 Gmail 대화목록 배열

승인

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

• https://mail.google.com/

---

getInboxUnreadCount()

받은편지함에서 읽지 않은 대화목록 수를 가져옵니다.

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

리턴

Integer: 읽지 않은 메시지가 있는 받은편지함의 대화목록 수

승인

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

• https://mail.google.com/

---

getMessageById(id)

ID로 메시지를 가져옵니다.

Gmail 메시지의 getId() 와 함께 사용합니다.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

매개변수

이름	유형	설명
id	String	검색할 메시지의 ID입니다.

리턴

GmailMessage: 지정된 ID가 있는 메시지

생성 값

Error: 지정된 ID의 메시지를 찾을 수 없는 경우

승인

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

• https://mail.google.com/

참고 항목

• getThreadById(id)

---

getMessagesForThread(thread)

지정된 스레드의 모든 메시지를 검색합니다.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

매개변수

이름	유형	설명
thread	GmailThread	가져올 메시지 스레드

리턴

GmailMessage[] — 이 대화목록에 해당하는 메시지 배열

승인

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

• https://mail.google.com/

참고 항목

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

지정된 스레드의 모든 메시지를 검색합니다.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

매개변수

이름	유형	설명
threads	GmailThread[]	검색할 메시지 스레드

리턴

GmailMessage[][]: 메시지 배열로, 외부 배열의 각 항목은 다음에 해당합니다. 내부 배열에 그 스레드의 메시지가 포함되어 있는 경우

승인

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

• https://mail.google.com/

참고 항목

• getMessagesForThread(thread)

---

getPriorityInboxThreads()

라벨에 관계없이 모든 자동분류함 대화목록을 검색합니다.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 대화목록 크기를 알 수 없으며 매우 클 수 있는 경우 '페이징됨' 호출 각 호출에서 검색할 스레드의 범위를 지정합니다.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

리턴

GmailThread[] - 자동분류함의 Gmail 대화목록 배열

승인

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

• https://mail.google.com/

---

getPriorityInboxThreads(start, max)

라벨과 관계없이 다양한 자동분류함 대화목록을 검색합니다.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

매개변수

이름	유형	설명
start	Integer	검색할 첫 번째 스레드의 색인
max	Integer	검색할 최대 스레드 수

리턴

GmailThread[] - 자동분류함의 Gmail 대화목록 배열

승인

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

• https://mail.google.com/

---

getPriorityInboxUnreadCount()

자동분류함의 읽지 않은 대화목록 수를 가져옵니다.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

리턴

Integer: 자동분류함의 읽지 않은 메일이 있는 대화목록 수

승인

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

• https://mail.google.com/

---

getSpamThreads()

라벨과 관계없이 모든 스팸 스레드를 검색합니다.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 대화목록 크기를 알 수 없으며 매우 클 수 있는 경우 '페이징됨' 호출 각 호출에서 검색할 스레드의 범위를 지정합니다.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

리턴

GmailThread[] - 스팸 폴더에 있는 Gmail 대화목록의 배열

승인

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

• https://mail.google.com/

---

getSpamThreads(start, max)

라벨과 관계없이 다양한 스팸 스레드를 검색합니다.

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

매개변수

이름	유형	설명
start	Integer	검색할 첫 번째 스레드의 색인
max	Integer	검색할 최대 스레드 수

리턴

GmailThread[] - 스팸 폴더에 있는 Gmail 대화목록의 배열

승인

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

• https://mail.google.com/

---

getSpamUnreadCount()

읽지 않은 스팸 대화목록의 수를 가져옵니다.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

리턴

Integer: 읽지 않은 메시지가 있는 스팸 대화목록 수

승인

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

• https://mail.google.com/

---

getStarredThreads()

라벨과 관계없이 별표표시된 모든 스레드를 검색합니다.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 대화목록 크기를 알 수 없으며 매우 클 수 있는 경우 '페이징됨' 호출 각 호출에서 검색할 스레드의 범위를 지정합니다.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

리턴

GmailThread[] - 별표표시된 Gmail 대화목록의 배열

승인

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

• https://mail.google.com/

---

getStarredThreads(start, max)

라벨과 관계없이 별표표시된 여러 스레드를 검색합니다.

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

매개변수

이름	유형	설명
start	Integer	검색할 첫 번째 스레드의 색인
max	Integer	검색할 최대 스레드 수

리턴

GmailThread[] - 별표표시된 Gmail 대화목록의 배열

승인

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

• https://mail.google.com/

---

getStarredUnreadCount()

별표표시된 읽지 않은 대화목록 수를 가져옵니다.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

리턴

Integer: 읽지 않은 메시지가 있는 별표표시된 대화목록 수

승인

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

• https://mail.google.com/

---

getThreadById(id)

ID별로 스레드를 가져옵니다.

Gmail 대화목록의 getId() 와 함께 사용합니다.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

매개변수

이름	유형	설명
id	String	검색할 스레드의 ID입니다.

리턴

GmailThread: 지정된 ID를 가진 스레드이거나 찾을 수 없는 경우 null입니다.

승인

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

• https://mail.google.com/

참고 항목

• getMessageById(id)

---

getTrashThreads()

라벨과 관계없이 모든 휴지통 스레드를 검색합니다.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 대화목록 크기를 알 수 없으며 매우 클 수 있는 경우 '페이징됨' 호출 각 호출에서 검색할 스레드의 범위를 지정합니다.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

리턴

GmailThread[] - 휴지통에 있는 Gmail 대화목록의 배열

승인

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

• https://mail.google.com/

---

getTrashThreads(start, max)

라벨과 관계없이 다양한 휴지통 스레드를 검색합니다.

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

매개변수

이름	유형	설명
start	Integer	검색할 첫 번째 스레드의 색인
max	Integer	검색할 최대 스레드 수

리턴

GmailThread[] - 휴지통에 있는 Gmail 대화목록의 배열

승인

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

• https://mail.google.com/

---

getUserLabelByName(name)

라벨 이름이 지정된 라벨을 검색합니다.

var labelObject = GmailApp.getUserLabelByName("myLabel");

매개변수

이름	유형	설명
name	String	검색할 라벨의 이름

리턴

GmailLabel: 지정된 이름의 Gmail 라벨

승인

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

• https://mail.google.com/

---

getUserLabels()

사용자가 만든 라벨 목록을 검색합니다.

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

리턴

GmailLabel[] - 사용자가 만든 라벨의 배열

승인

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

• https://mail.google.com/

---

markMessageRead(message)

이 메일을 읽음으로 표시하고 메일을 강제로 새로고침합니다.

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

매개변수

이름	유형	설명
message	GmailMessage	읽음으로 표시할 메일

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markMessageUnread(message)

---

markMessageUnread(message)

메일을 읽지않음으로 표시하고 강제로 새로고침합니다.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

매개변수

이름	유형	설명
message	GmailMessage	읽지않음으로 표시할 메시지

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markMessageRead(message)

---

markMessagesRead(messages)

메일을 읽음으로 표시하고 강제로 새로고침합니다.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

매개변수

이름	유형	설명
messages	GmailMessage[]	읽음으로 표시할 메시지의 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markMessagesUnread(messages)

---

markMessagesUnread(messages)

메일을 읽지 않음으로 표시하고 강제로 새로고침합니다.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

매개변수

이름	유형	설명
messages	GmailMessage[]	읽지않음으로 표시할 메시지의 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markMessagesRead(messages)

---

markThreadImportant(thread)

이 대화목록을 중요한 메일로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

매개변수

이름	유형	설명
thread	GmailThread	중요한 메일로 표시할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadUnimportant(thread)

---

markThreadRead(thread)

이 스레드를 읽음으로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

매개변수

이름	유형	설명
thread	GmailThread	읽음으로 표시할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

이 스레드를 중요하지 않은 것으로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

매개변수

이름	유형	설명
thread	GmailThread	중요하지 않은 메일로 표시할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadImportant(thread)

---

markThreadUnread(thread)

이 대화목록을 읽지 않음으로 표시하고 강제로 대화목록을 새로고침합니다.

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

매개변수

이름	유형	설명
thread	GmailThread	읽지않음으로 표시할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadRead(thread)

---

markThreadsImportant(threads)

이러한 스레드를 중요한 것으로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

매개변수

이름	유형	설명
threads	GmailThread[]	중요한 것으로 표시할 스레드의 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

이러한 스레드를 읽음으로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

매개변수

이름	유형	설명
threads	GmailThread[]	읽음으로 표시할 스레드 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

이러한 스레드를 중요하지 않은 것으로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

매개변수

이름	유형	설명
threads	GmailThread[]	중요하지 않은 대화로 표시할 스레드 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadsImportant(threads)

---

markThreadsUnread(threads)

이러한 대화목록을 읽지 않음으로 표시하고 스레드를 강제로 새로고침합니다.

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

매개변수

이름	유형	설명
threads	GmailThread[]	읽지않음으로 표시할 스레드 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• markThreadsRead(threads)

---

moveMessageToTrash(message)

메일을 휴지통으로 이동하고 강제로 메일을 새로고침합니다.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

매개변수

이름	유형	설명
message	GmailMessage	휴지통으로 이동할 메일

리턴

GmailApp - Gmail 서비스 (체이닝에 유용)

승인

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

• https://mail.google.com/

참고 항목

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

지정된 메일을 휴지통으로 이동하고 강제로 메일을 새로고침합니다.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

매개변수

이름	유형	설명
messages	GmailMessage[]	휴지통으로 이동할 메일

리턴

GmailApp - Gmail 서비스 (체이닝에 유용)

승인

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

• https://mail.google.com/

참고 항목

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

이 대화목록을 자료실로 이동하고 강제로 대화목록을 새로고침합니다.

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

매개변수

이름	유형	설명
thread	GmailThread	보관처리할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToTrash(thread)

---

moveThreadToInbox(thread)

이 대화목록을 받은편지함으로 이동하고 강제로 대화목록을 새로고침합니다.

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

매개변수

이름	유형	설명
thread	GmailThread	받은편지함으로 이동할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadToTrash(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadToSpam(thread)

이 대화목록을 스팸으로 이동하고 강제로 새로고침합니다.

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

매개변수

이름	유형	설명
thread	GmailThread	스팸함으로 이동할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadToTrash(thread)
• moveThreadToInbox(thread)
• moveThreadToArchive(thread)

---

moveThreadToTrash(thread)

이 대화목록을 휴지통으로 이동하고 강제로 대화목록을 새로고침합니다.

// Move first thread in inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToTrash(firstThread);

매개변수

이름	유형	설명
thread	GmailThread	휴지통으로 이동할 대화목록

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadsToArchive(threads)

이러한 대화목록을 보관 파일로 이동하고 대화목록을 강제로 새로고침합니다.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

매개변수

이름	유형	설명
threads	GmailThread[]	보관처리할 대화목록 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToTrash(threads)

---

moveThreadsToInbox(threads)

대화목록을 받은편지함으로 이동하고 대화목록을 강제로 새로고침합니다.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

매개변수

이름	유형	설명
threads	GmailThread[]	받은편지함으로 이동할 대화목록 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadsToTrash(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToSpam(threads)

이러한 대화목록을 스팸으로 이동하고 대화목록을 강제로 새로고침합니다.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

매개변수

이름	유형	설명
threads	GmailThread[]	스팸으로 이동할 대화목록 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadsToInbox(threads)
• moveThreadsToTrash(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToTrash(threads)

스레드를 휴지통으로 이동하고 스레드를 강제로 새로고침합니다.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

매개변수

이름	유형	설명
threads	GmailThread[]	휴지통으로 이동할 스레드 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

refreshMessage(message)

Gmail에서 메일 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

매개변수

이름	유형	설명
message	GmailMessage	새로고침할 메시지

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• refreshMessages(messages)

---

refreshMessages(messages)

Gmail에서 메일 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

매개변수

이름	유형	설명
messages	GmailMessage[]	새로고침할 메시지가

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• refreshMessage(message)

---

refreshThread(thread)

Gmail에서 대화목록 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

매개변수

이름	유형	설명
thread	GmailThread	새로고침할 스레드입니다.

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• refreshThreads(threads)

---

refreshThreads(threads)

Gmail에서 스레드 및 관련 상태를 다시 로드합니다 (라벨, 읽기 상태, 등이 변경됨).

var threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

매개변수

이름	유형	설명
threads	GmailThread[]	새로고침할 스레드

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• refreshThread(thread)

---

search(query)

지정된 검색어로 Gmail을 검색합니다.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 대화목록 크기를 알 수 없으며 매우 클 수 있는 경우 '페이징됨' 호출 각 호출에서 검색할 스레드의 범위를 지정합니다.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

매개변수

이름	유형	설명
query	String	Gmail에 입력하는 것과 같은 검색어

리턴

GmailThread[]: 이 쿼리와 일치하는 Gmail 스레드의 배열

승인

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

• https://mail.google.com/

---

search(query, start, max)

지정된 검색어로 Gmail을 검색합니다.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

매개변수

이름	유형	설명
query	String	Gmail에 입력하는 것과 같은 검색어
start	Integer	시작 스레드의 인덱스
max	Integer	반환할 최대 스레드 수

리턴

GmailThread[]: 이 쿼리와 일치하는 Gmail 스레드의 배열

승인

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

• https://mail.google.com/

---

sendEmail(recipient, subject, body)

이메일 메시지를 보냅니다. 헤더를 포함한 이메일의 크기는 할당량으로 제한되어 있습니다.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("[e-mail]", "current time", "The time is: " + now.toString());

매개변수

이름	유형	설명
recipient	String	쉼표로 구분된 이메일 주소 목록
subject	String	이메일 제목 (영문 기준 최대 250자)
body	String	이메일 본문입니다.

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

선택적 인수를 사용하여 이메일 메시지를 보냅니다. 이메일에는 일반 텍스트 또는 HTML을 포함할 수 있습니다. 본문입니다. 이메일의 크기 (헤더 포함, 첨부파일 제외)는 할당량이 제한됩니다.

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('[e-mail]', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

매개변수

이름	유형	설명
recipient	String	수신자의 주소
subject	String	제목 (영문 기준 최대 250자)
body	String	이메일의 본문입니다.
options	Object	아래 나열된 고급 매개변수를 지정하는 JavaScript 객체

고급 매개변수

이름	유형	설명
attachments	BlobSource[]	- 이메일로 보낼 파일의 배열
bcc	String	숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록
cc	String	참조로 추가할 이메일 주소의 쉼표로 구분된 목록
from	String	이메일이 전송되어야 하는 주소이며 getAliases()에서 반환한 값의 백분율
htmlBody	String	설정된 경우 HTML을 렌더링할 수 있는 기기에서 HTML을 대신 사용합니다. 필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 inlineImages 필드를 추가할 수 있습니다. 이메일에 인라인 이미지가 있는 경우 본문
inlineImages	Object	이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다.
name	String	이메일 발신자의 이름 (기본값: 사용자 이름)
noReply	Boolean	true 일반 웹 주소로 이메일을 보내야 하는 경우 수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은 Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음
replyTo	String	기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소)

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• sendEmail(recipient, subject, body)

---

setCurrentMessageAccessToken(accessToken)

현재 메시지 설정 스크립트가 현재 GmailMessage 속성에 액세스할 수 있도록 하는 액세스 토큰입니다.

Gmail 현재 메일 범위를 사용하는 Google Workspace 부가기능 프로젝트만 이 메서드가 필요합니다.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

매개변수

이름	유형	설명
accessToken	String	Gmail 부가기능 작업 이벤트 객체에서 가져온 임시 액세스 토큰

승인

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

• https://mail.google.com/

---

starMessage(message)

메일에 별표를 추가하고 메일을 강제로 새로고침합니다.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

매개변수

이름	유형	설명
message	GmailMessage	별표표시 메시지

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• starMessages(messages)

---

starMessages(messages)

메일에 별표를 추가하고 메일을 강제로 새로고침합니다.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

매개변수

이름	유형	설명
messages	GmailMessage[]	별표표시할 메시지의 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• starMessage(message)

---

unstarMessage(message)

이 메일에서 별표를 삭제하고 메일을 강제로 새로고침합니다.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

매개변수

이름	유형	설명
message	GmailMessage	별표 삭제 메시지

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• unstarMessages(messages)

---

unstarMessages(messages)

이러한 메일에서 별표를 삭제하고 메일을 강제로 새로고침합니다.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

매개변수

이름	유형	설명
messages	GmailMessage[]	별표를 삭제할 메시지 배열

리턴

GmailApp: Gmail 서비스, 체인에 유용한 서비스

승인

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

• https://mail.google.com/

참고 항목

• unstarMessage(message)

지원 중단된 메서드

getChatThreads()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에 사용하면 안 됩니다.

Google에서 모두 전환할 때까지 모든 기존 Google 행아웃 대화목록과 Google Chat 대화목록을 가져옵니다. 기존 행아웃 사용자를 올해 말에 Chat으로 이전할 수 있습니다. 자세한 내용은 알아보기 기존 행아웃에서 Google Chat으로의 전환에 관해 자세히 알아보세요.

이 호출은 모든 스레드의 크기가 너무 커서 시스템이 처리할 수 없는 경우 실패합니다. 위치 스레드의 크기를 알 수 없으며, 잠재적으로 매우 클 수 있는 경우 '페이징됨' 호출하고 각 호출에서 검색할 스레드의 범위입니다.

var threads = GmailApp.getChatThreads();
Logger.log("# of chat threads: " + threads.length);

리턴

GmailThread[] - Gmail의 채팅 대화목록 배열입니다.

승인

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

• https://mail.google.com/

---

getChatThreads(start, max)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에 사용하면 안 됩니다.

Google이 전환될 때까지 다양한 기존 Google 행아웃 대화목록과 Google Chat 대화목록을 가져옵니다. 기존 행아웃의 모든 사용자를 Chat으로 이전할 수 있습니다. 자세한 내용은 알아보기 기존 행아웃에서 Google Chat으로의 전환에 관해 자세히 알아보세요.

// Get first 50 chat threads
var threads = GmailApp.getChatThreads(0,50);
// Will log no more than 50.0
Logger.log(threads.length);
Logger.log(threads[0].getFirstMessageSubject());

매개변수

이름	유형	설명
start	Integer	검색할 첫 번째 스레드의 색인
max	Integer	검색할 최대 스레드 수

리턴

GmailThread[] - Gmail 채팅 대화목록의 배열

승인

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

• https://mail.google.com/