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)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이메일 본문

리턴

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아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

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

리턴

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새 라벨의 이름

리턴

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삭제할 라벨

리턴

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

리턴

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

리턴

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

매개변수

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

리턴

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

매개변수

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

리턴

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검색할 메시지 대화목록

리턴

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[]가져올 메시지 대화목록

리턴

GmailMessage[][] - 메시지 배열의 배열. 외부 배열의 각 항목은 스레드에 해당하고 내부 배열에는 스레드의 메시지가 포함됩니다.

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

리턴

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

매개변수

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

리턴

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

매개변수

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

리턴

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

매개변수

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

리턴

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

승인

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

  • https://mail.google.com/

참고 항목


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

매개변수

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

리턴

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

승인

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

  • https://mail.google.com/

getUserLabelByName(name)

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

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

매개변수

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

리턴

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

매개변수

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

리턴

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읽지않음으로 표시할 메시지

리턴

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[]읽음으로 표시할 메시지 배열

리턴

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[]읽지 않은 상태로 표시할 메시지의 배열

리턴

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중요 메일로 표시할 대화목록

리턴

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읽음으로 표시할 스레드

리턴

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중요하지 않은 것으로 표시하는 대화목록

리턴

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대화목록을 읽지않음으로 표시

리턴

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[]중요한 항목으로 표시할 스레드 배열

리턴

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[]읽음으로 표시할 스레드 배열

리턴

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[]중요하지 않은 것으로 표시할 스레드 배열

리턴

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[]읽지않음으로 표시할 스레드 배열

리턴

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휴지통으로 이동할 메일

리턴

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[]휴지통으로 이동할 메일

리턴

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보관처리할 대화목록

리턴

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받은편지함으로 이동할 대화목록

리턴

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스팸으로 이동할 대화목록

리턴

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휴지통으로 이동할 대화목록

리턴

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[]보관처리할 스레드의 배열

리턴

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[]받은편지함으로 이동할 대화목록의 배열

리턴

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[]스팸으로 이동할 대화목록의 배열

리턴

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[]휴지통으로 이동할 스레드 배열

리턴

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새로고침해야 할 메시지

리턴

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[]새로고침해야 할 메시지

리턴

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새로고침할 스레드

리턴

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[]새로고침할 스레드

리턴

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에 입력하는 방식)

리턴

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반환할 최대 스레드 수

리턴

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이메일 본문

리턴

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아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

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

리턴

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별표표시할 메시지

리턴

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[]별표표시할 메시지의 배열

리턴

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별표 삭제 메시지

리턴

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[]별표를 삭제할 메시지 배열

리턴

GmailApp: Gmail 서비스, 연결에 유용함

승인

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

  • https://mail.google.com/

참고 항목

지원 중단된 메서드