Gmail Service

Gmail

이 서비스를 사용하면 이메일을 보내고, 임시보관 메일을 작성하고, 라벨을 관리하고, 메시지 및 대화목록을 표시하고, 기타 다양한 Gmail 계정 관리 작업을 수행할 수 있습니다. 이메일 전송만 허용하는 간단한 서비스인 메일 서비스도 참조하세요.

클래스

이름간략한 설명
GmailAppGmail 대화목록, 메일, 라벨에 대한 액세스 권한을 제공합니다.
GmailAttachmentGmail에서 보낸 첨부파일입니다.
GmailDraft사용자의 Gmail 계정에서 사용자가 만든 임시보관 메일
GmailLabel사용자의 Gmail 계정에 있는 사용자 생성 라벨
GmailMessage사용자의 Gmail 계정에 있는 메일입니다.
GmailThread사용자의 Gmail 계정에 있는 대화목록입니다.

GmailApp

방법

메서드반환 유형간략한 설명
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이러한 메일에서 별표를 삭제하고 메일을 강제로 새로고침합니다.

GmailAttachment

방법

메서드반환 유형간략한 설명
copyBlob()Blob이 blob의 사본을 반환합니다.
getAs(contentType)Blob이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
getBytes()Byte[]이 blob에 저장된 데이터를 가져옵니다.
getContentType()String이 blob에서 바이트의 콘텐츠 유형을 가져옵니다.
getDataAsString()String이 blob의 데이터를 UTF-8 인코딩을 사용한 문자열로 가져옵니다.
getDataAsString(charset)String이 blob의 데이터를 지정된 인코딩이 포함된 문자열로 가져옵니다.
getHash()String이 첨부파일의 SHA1 콘텐츠 해시를 가져옵니다.
getName()String이 blob의 이름을 가져옵니다.
getSize()Integer첨부파일의 크기를 가져옵니다.
isGoogleType()Boolean이 blob이 Google Workspace 파일 (Sheets, Docs 등)인지 여부를 반환합니다.
setBytes(data)Blob이 blob에 저장되는 데이터를 설정합니다.
setContentType(contentType)Blob이 blob에 있는 바이트의 콘텐츠 유형을 설정합니다.
setContentTypeFromExtension()Blob파일 확장자에 따라 이 blob에 있는 바이트의 콘텐츠 유형을 설정합니다.
setDataFromString(string)BlobUTF-8로 인코딩되는 문자열에서 이 blob의 데이터를 설정합니다.
setDataFromString(string, charset)Blob지정된 인코딩을 사용하여 문자열에서 이 blob의 데이터를 설정합니다.
setName(name)Blob이 blob의 이름을 설정합니다.

GmailDraft

방법

메서드반환 유형간략한 설명
deleteDraft()void이 임시보관 메일을 삭제합니다.
getId()String이 임시보관 메일의 ID를 가져옵니다.
getMessage()GmailMessage이 초안을 나타내는 GmailMessage를 반환합니다.
getMessageId()String이 초안을 나타내는 GmailMessage의 ID를 반환합니다.
send()GmailMessage이 임시보관 이메일 메시지를 보냅니다.
update(recipient, subject, body)GmailDraft이 임시보관 메일의 내용을 대체합니다.
update(recipient, subject, body, options)GmailDraft선택적 인수를 사용하여 이 초안 메시지의 내용을 대체합니다.

GmailLabel

방법

메서드반환 유형간략한 설명
addToThread(thread)GmailLabel이 라벨을 지정된 스레드에 추가하고 스레드를 강제로 새로고침합니다 (GmailThread.refresh()).
addToThreads(threads)GmailLabel이 라벨을 지정된 스레드에 추가하고 스레드를 강제로 새로고침합니다.
deleteLabel()void이 라벨을 삭제합니다.
getName()String이 라벨의 이름을 가져옵니다.
getThreads()GmailThread[]이 라벨로 표시된 스레드를 가져옵니다.
getThreads(start, max)GmailThread[]이 라벨로 표시된 스레드 범위를 가져옵니다.
getUnreadCount()Integer이 라벨로 태그가 지정된 읽지 않은 대화목록의 수를 가져옵니다.
removeFromThread(thread)GmailLabel지정된 스레드에서 이 라벨을 삭제하고 스레드를 강제로 새로고침합니다.
removeFromThreads(threads)GmailLabel지정된 스레드에서 이 라벨을 삭제하고 스레드를 강제로 새로고침합니다.

GmailMessage

방법

메서드반환 유형간략한 설명
createDraftReply(body)GmailDraft답장 주소를 사용하여 이 메일의 발신자에게 답장하는 임시보관 메일을 만듭니다.
createDraftReply(body, options)GmailDraft답장 주소와 선택적 인수를 사용하여 이 메시지의 발신자에게 답장하는 임시보관 메시지를 만듭니다.
createDraftReplyAll(body)GmailDraft답장 주소와 이 메시지의 모든 수신자를 사용하여 발신자에게 보내는 임시보관 메시지를 만듭니다.
createDraftReplyAll(body, options)GmailDraft답장 주소 및 모든 수신자와 선택적 인수를 사용하여 이 메시지의 발신자에게 답장하는 임시보관 메시지를 만듭니다.
forward(recipient)GmailMessage이 메일을 새 수신자에게 전달합니다.
forward(recipient, options)GmailMessage선택적 인수를 사용하여 이 메일을 새 수신자에게 전달합니다.
getAttachments()GmailAttachment[]이 메일의 모든 첨부파일을 가져옵니다.
getAttachments(options)GmailAttachment[]이 메일의 모든 첨부파일을 가져옵니다.
getBcc()String이 메일에 숨은참조로 지정된 쉼표로 구분된 수신자를 가져옵니다.
getBody()String이 메시지 본문의 HTML 콘텐츠를 가져옵니다.
getCc()String이 메일에 참조된 쉼표로 구분된 수신자를 가져옵니다.
getDate()Date이 메시지의 날짜와 시간을 가져옵니다.
getFrom()String이 메시지의 발신자를 가져옵니다.
getHeader(name)String헤더 이름이 지정된 RFC 2822 헤더의 값을 가져옵니다.
getId()String이 메시지의 ID를 가져옵니다.
getPlainBody()StringHTML 형식 없이 메시지 본문의 콘텐츠를 가져옵니다.
getRawContent()String이 메시지의 원시 콘텐츠를 가져옵니다.
getReplyTo()String이 메일의 답장 주소 (일반적으로 발신자)를 가져옵니다.
getSubject()String이 메시지의 제목을 가져옵니다.
getThread()GmailThread이 메시지가 포함된 스레드를 가져옵니다.
getTo()String이 메시지의 쉼표로 구분된 수신자를 가져옵니다.
isDraft()Boolean이 메시지의 임시보관 메시지인지 여부를 가져옵니다.
isInChats()Boolean이 메시지가 채팅인지 여부를 가져옵니다.
isInInbox()Boolean이 메일이 받은편지함에 있는지 여부를 확인합니다.
isInPriorityInbox()Boolean이 메시지가 중요 받은편지함에 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다.
isInTrash()Boolean메일이 휴지통에 있는지 여부를 확인합니다.
isStarred()Boolean이 메시지에 별표 표시 여부를 가져옵니다.
isUnread()Boolean이 메시지의 읽지않음 여부를 확인합니다.
markRead()GmailMessage메일을 읽음으로 표시합니다.
markUnread()GmailMessage메일을 읽지않음으로 표시합니다.
moveToTrash()GmailMessage메일을 휴지통으로 이동합니다.
refresh()GmailMessageGmail에서 이 메시지와 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
reply(body)GmailMessage답장받을 주소를 사용하여 이 메일의 발신자에게 답장을 보냅니다.
reply(body, options)GmailMessage선택적 인수를 사용하여 답장받을 주소를 사용하여 이 메일의 발신자에게 답장을 보냅니다.
replyAll(body)GmailMessage답장받을 주소와 이 메일의 모든 수신자를 사용하여 발신자에게 답장합니다.
replyAll(body, options)GmailMessage답장 주소 및 모든 수신자와 함께 선택적 인수를 사용하여 이 메시지의 발신자에게 답장합니다.
star()GmailMessage메일에 별표표시합니다.
unstar()GmailMessage메시지의 별표를 삭제합니다.

GmailThread

방법

메서드반환 유형간략한 설명
addLabel(label)GmailThread이 라벨을 대화목록에 추가합니다.
createDraftReply(body)GmailDraft답장 주소를 사용하여 이 스레드의 마지막 메시지 발신자에게 답장하는 임시보관 메시지를 만듭니다.
createDraftReply(body, options)GmailDraft선택적 인수와 함께 답장 주소를 사용하여 이 스레드의 마지막 메시지 발신자에게 회신하는 초안 메시지를 만듭니다.
createDraftReplyAll(body)GmailDraft답장 주소와 이 메시지의 모든 수신자를 사용하여 이 스레드의 마지막 메시지 발신자에게 회신하는 임시보관 메시지를 만듭니다.
createDraftReplyAll(body, options)GmailDraft답장 주소 및 모든 수신자와 선택적 인수를 사용하여 이 스레드의 마지막 메시지 발신자에게 회신하는 임시보관 메시지를 만듭니다.
getFirstMessageSubject()String대화목록에 있는 첫 번째 메시지의 제목을 가져옵니다.
getId()String이 스레드의 ID를 가져옵니다.
getLabels()GmailLabel[]이 스레드에 사용자가 만든 라벨을 반환합니다.
getLastMessageDate()Date이 스레드의 가장 최근 메시지의 날짜를 가져옵니다.
getMessageCount()Integer대화목록에 있는 메시지 수를 반환합니다.
getMessages()GmailMessage[]이 대화목록의 메시지를 가져옵니다.
getPermalink()String이 스레드의 퍼머링크를 가져옵니다.
hasStarredMessages()Boolean대화목록에 별표 표시된 메시지가 있는지 여부를 반환합니다.
isImportant()Boolean스레드가 중요 대화로 표시되었는지 여부를 반환합니다.
isInChats()Boolean대화목록에 채팅 라벨이 지정되었는지 여부를 반환합니다.
isInInbox()Boolean대화목록이 받은편지함에 있는지 여부를 반환합니다.
isInPriorityInbox()Boolean이 스레드가 우선순위 수신함에 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다.
isInSpam()Boolean대화목록이 스팸으로 표시되었는지 여부를 반환합니다.
isInTrash()Boolean스레드가 휴지통에 있는지 여부를 반환합니다.
isUnread()Boolean대화목록에 읽지 않은 메시지가 있는지 여부를 반환합니다.
markImportant()GmailThread이 대화목록을 중요 메일로 표시합니다.
markRead()GmailThread이 스레드를 읽음으로 표시합니다.
markUnimportant()GmailThread이 대화목록을 중요하지 않은 대화로 표시합니다.
markUnread()GmailThread이 대화목록을 읽지않음으로 표시합니다.
moveToArchive()GmailThread이 대화목록을 보관 파일로 이동합니다.
moveToInbox()GmailThread이 대화목록을 받은편지함으로 이동합니다.
moveToSpam()GmailThread이 대화목록을 스팸으로 이동합니다.
moveToTrash()GmailThread이 대화목록을 휴지통으로 이동합니다.
refresh()GmailThreadGmail에서 이 스레드와 관련 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).
removeLabel(label)GmailThread대화목록에서 이 라벨을 삭제합니다.
reply(body)GmailThread회신 주소를 사용하여 이 대화목록에서 마지막 메시지의 발신자에게 답장합니다.
reply(body, options)GmailThread선택적 인수를 사용하여 답장 주소를 사용하여 이 스레드의 마지막 메시지의 발신자에게 답장을 보냅니다.
replyAll(body)GmailThread보낸사람 (답장 주소 사용)과 이 대화목록에서 마지막 메시지의 모든 수신자에게 답장합니다.
replyAll(body, options)GmailThread발신자 (replyTo 주소 사용)와 이 스레드의 마지막 메시지의 모든 수신자에게 선택적 인수를 사용하여 답장합니다.