Class GmailApp

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Gmail 앱

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

메서드

메서드반환 유형간략한 설명
createDraft(recipient, subject, body)GmailDraft임시보관 이메일 메시지를 만듭니다.
createDraft(recipient, subject, body, options)GmailDraft선택적 인수를 사용하여 이메일 초안을 만듭니다.
createLabel(name)GmailLabel특정 이름의 새 사용자 라벨을 만듭니다.
deleteLabel(label)GmailApp지정된 라벨을 삭제합니다.
getAliases()String[]Gmail에서 이 계정의 별칭으로 설정된 이메일 목록을 가져옵니다.
getDraft(draftId)GmailDraftID로 이메일 메시지 초안을 검색합니다.
getDraftMessages()GmailMessage[]모든 임시보관 메시지를 검색합니다.
getDrafts()GmailDraft[]모든 Gmail 임시보관 메일을 가져옵니다.
getInboxThreads()GmailThread[]라벨과 관계없이 모든 받은편지함 대화목록을 검색합니다.
getInboxThreads(start, max)GmailThread[]라벨과 관계없이 받은편지함의 다양한 대화목록을 검색합니다.
getInboxUnreadCount()Integer받은편지함의 읽지 않은 대화목록 수를 가져옵니다.
getMessageById(id)GmailMessageID별로 메시지를 가져옵니다.
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)GmailThreadID별로 스레드를 가져옵니다.
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)GmailAppGmail에서 메시지 및 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
refreshMessages(messages)GmailAppGmail에서 메시지 및 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
refreshThread(thread)GmailAppGmail에서 스레드 및 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
refreshThreads(threads)GmailAppGmail에서 스레드와 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
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이러한 메시지에서 별표를 삭제하고 메시지를 강제로 새로고침합니다.

자세한 문서

createDraft(recipient, subject, body)

임시보관 이메일 메시지를 만듭니다. 헤더를 포함한 이메일 크기는 할당량 제한입니다.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());

매개변수

이름유형설명
recipientString쉼표로 구분된 이메일 주소 목록
subjectString이메일의 제목
bodyString이메일 본문

Return

GmailDraft: 새로 생성된 Gmail임시보관함

승인

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

  • https://mail.google.com/

참고 항목


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('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

매개변수

이름유형설명
recipientString수신자의 주소
subjectString제목
bodyString이메일 본문
optionsObject고급 매개변수를 지정하는 자바스크립트 객체(아래 참조)

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 전송할 파일 배열
bccString쉼표로 구분된 숨은참조 이메일 주소 목록
ccString참조에 추가할 이메일 주소 목록(쉼표로 구분)
fromString이메일을 보낼 주소이며 getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정된 경우 HTML을 렌더링할 수 있는 기기가 필수 본문 인수 대신 이 필드를 사용합니다. 이메일 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터 (BlobSource)로의 매핑이 포함된 자바스크립트 객체. 여기서는 htmlBody 매개변수가 사용된다고 가정하고 이러한 이미지에 대한 참조를 <img src="cid:imageKey" /> 형식으로 포함합니다.
nameString이메일 발신자 이름 (기본값: 사용자 이름)
replyToString기본 답장받을 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)

Return

GmailDraft: 새로 생성된 Gmail임시보관함

승인

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

  • https://mail.google.com/

참고 항목


createLabel(name)

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

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

매개변수

이름유형설명
nameString새 라벨의 이름

Return

GmailLabel: 새로 생성된 라벨

승인

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

  • https://mail.google.com/

참고 항목


deleteLabel(label)

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

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

매개변수

이름유형설명
labelGmailLabel삭제할 라벨

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


getAliases()

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

'from' 옵션 인수를 사용하여 이러한 별칭에서 메시지를 보낼 수 있습니다.

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

Return

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

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

Return

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

Return

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

Return

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

Return

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

매개변수

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

Return

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

승인

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

  • https://mail.google.com/

getInboxUnreadCount()

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

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

Return

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

매개변수

이름유형설명
idString검색할 메시지의 ID

Return

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

예외 처리

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

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

이름유형설명
threadGmailThread검색할 메시지의 대화목록

Return

GmailMessage[]: 이 스레드에 해당하는 메시지 배열

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

이름유형설명
threadsGmailThread[]검색할 메시지의 대화목록

Return

GmailMessage[][]: 메시지 배열의 배열로, 외부 배열의 각 항목은 스레드에 해당하며 내부 배열은 스레드의 메시지를 포함합니다.

승인

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

  • https://mail.google.com/

참고 항목


getPriorityInboxThreads()

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

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없으며 잠재적으로 매우 큰 경우 '페이지 호출'을 사용하고 각 호출에서 검색할 스레드 범위를 지정하세요.

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

Return

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

매개변수

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

Return

GmailThread[]: 자동분류함에 있는 Gmail 대화목록의 배열입니다.

승인

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

  • https://mail.google.com/

getPriorityInboxUnreadCount()

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

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

Return

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

승인

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

  • https://mail.google.com/

getSpamThreads()

라벨과 관계없이 모든 스팸 대화목록을 검색합니다.

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없으며 잠재적으로 매우 큰 경우 '페이지 호출'을 사용하고 각 호출에서 검색할 스레드 범위를 지정하세요.

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

Return

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

매개변수

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

Return

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

Return

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

승인

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

  • https://mail.google.com/

getStarredThreads()

라벨과 관계없이 별표표시된 모든 대화목록을 검색합니다.

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없으며 잠재적으로 매우 큰 경우 '페이지 호출'을 사용하고 각 호출에서 검색할 스레드 범위를 지정하세요.

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

Return

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

매개변수

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

Return

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

승인

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

  • https://mail.google.com/

getStarredUnreadCount()

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

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

Return

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

승인

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

  • https://mail.google.com/

getThreadById(id)

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

Gmail 스레드에서 getId()와 함께 사용하세요.

// Thread IDs can also be found in the location bar when you have a thread open in Gmail
// get first inbox thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
// Get the same thread by ID
var threadById = GmailApp.getThreadById(firstThread.getId());
// Verify they are the same
Logger.log(firstThread.getFirstMessageSubject() == threadById.getFirstMessageSubject());

매개변수

이름유형설명
idString가져올 스레드의 ID

Return

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

승인

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

  • https://mail.google.com/

참고 항목


getTrashThreads()

라벨과 관계없이 모든 휴지통 대화목록을 검색합니다.

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없으며 잠재적으로 매우 큰 경우 '페이지 호출'을 사용하고 각 호출에서 검색할 스레드 범위를 지정하세요.

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

Return

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

매개변수

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

Return

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

승인

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

  • https://mail.google.com/

getUserLabelByName(name)

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

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

매개변수

이름유형설명
nameString가져올 라벨의 이름

Return

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

Return

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

매개변수

이름유형설명
messageGmailMessage읽음으로 표시할 메시지

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

이름유형설명
messageGmailMessage읽지 않은 상태로 표시할 메시지

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadImportant(thread)

이 대화목록을 중요한 것으로 표시하고 대화목록을 강제로 새로고침합니다.

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

매개변수

이름유형설명
threadGmailThread중요한 대화목록으로 표시하는 대화목록

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadRead(thread)

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

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadUnimportant(thread)

이 대화목록을 중요하지 않은 것으로 표시하고 대화목록을 강제로 새로고침합니다.

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

매개변수

이름유형설명
threadGmailThread중요하지 않은 것으로 표시하는 대화목록

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadUnread(thread)

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

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

매개변수

이름유형설명
threadGmailThread읽지 않은 상태로 표시하는 대화목록

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadsImportant(threads)

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

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

매개변수

이름유형설명
threadsGmailThread[]중요 항목으로 표시할 스레드 배열

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadsRead(threads)

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

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadsUnimportant(threads)

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

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

매개변수

이름유형설명
threadsGmailThread[]중요하지 않은 것으로 표시할 스레드 배열

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


markThreadsUnread(threads)

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

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

매개변수

이름유형설명
threadsGmailThread[]읽지 않은 것으로 표시할 스레드 배열

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

이름유형설명
messageGmailMessage삭제할 메일

Return

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

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

이름유형설명
messagesGmailMessage[]삭제할 메일

Return

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

승인

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

  • https://mail.google.com/

참고 항목


moveThreadToArchive(thread)

이 대화목록을 보관 항목으로 이동하고 강제로 새로고침합니다.

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadToInbox(thread)

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

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadToSpam(thread)

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

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

매개변수

이름유형설명
threadGmailThread대화목록을 스팸으로 이동

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadToTrash(thread)

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

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadsToArchive(threads)

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

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

매개변수

이름유형설명
threadsGmailThread[]보관처리할 스레드 배열

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadsToInbox(threads)

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

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadsToSpam(threads)

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

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

매개변수

이름유형설명
threadsGmailThread[]스팸으로 이동할 스레드 배열

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


moveThreadsToTrash(threads)

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

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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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...

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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...

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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 ...

매개변수

이름유형설명
threadGmailThread새로고침할 대화목록

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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 ...

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


search(query)

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

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없으며 잠재적으로 매우 큰 경우 '페이지 호출'을 사용하고 각 호출에서 검색할 스레드 범위를 지정하세요.

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

매개변수

이름유형설명
queryString사용자가 Gmail에 입력할 때 사용하는 검색어

Return

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

매개변수

이름유형설명
queryString사용자가 Gmail에 입력할 때 사용하는 검색어
startInteger시작 스레드의 색인
maxInteger반환할 최대 스레드 수

Return

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("mike@example.com", "current time", "The time is: " + now.toString());

매개변수

이름유형설명
recipientString쉼표로 구분된 이메일 주소 목록
subjectString이메일 제목 (영문 기준 최대 250자)
bodyString이메일 본문

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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('mike@example.com', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

매개변수

이름유형설명
recipientString수신자의 주소
subjectString제목 (최대 250자)
bodyString이메일 본문
optionsObject고급 매개변수를 지정하는 자바스크립트 객체(아래 참조)

고급 매개변수

이름유형설명
attachmentsBlobSource[]이메일과 함께 전송할 파일 배열
bccString쉼표로 구분된 숨은참조 이메일 주소 목록
ccString참조에 추가할 이메일 주소 목록(쉼표로 구분)
fromString이메일을 보낼 주소이며 getAliases()에서 반환된 값 중 하나여야 합니다.
htmlBodyString설정된 경우 HTML을 렌더링할 수 있는 기기가 필수 본문 인수 대신 이 필드를 사용합니다. 이메일 인라인 이미지가 있는 경우 HTML 본문에 inlineImages 필드를 추가할 수 있습니다.
inlineImagesObject이미지 키(String)에서 이미지 데이터(BlobSource)로의 매핑이 포함된 자바스크립트 객체. 여기서는 htmlBody 매개변수가 사용된다고 가정하고 이러한 이미지에 대한 참조를 <img src="cid:imageKey" /> 형식으로 포함합니다.
nameString이메일 발신자 이름 (기본값: 사용자 이름)
noReplyBooleantrue: 이메일 답장에 사용할 수 없는 일반 이메일 주소에서 이메일을 보내야 하는 경우: 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 가능합니다.
replyToString기본 답장받을 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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
}

매개변수

이름유형설명
accessTokenStringGmail 부가기능 작업 이벤트 객체에서 가져온 임시 액세스 토큰입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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);

매개변수

이름유형설명
messageGmailMessage별표표시할 메시지

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

이름유형설명
messageGmailMessage별표 삭제하라는 메시지

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

Return

GmailApp: 체이닝에 유용한 Gmail 서비스

승인

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

  • https://mail.google.com/

참고 항목

지원 중단된 메서드