이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Gmail Service

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

클래스

이름	간략한 설명
`GmailApp`	Gmail 대화목록, 메일, 라벨에 대한 액세스를 제공합니다.
`GmailAttachment`	Gmail의 첨부파일입니다.
`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)`	`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`	이러한 메시지에서 별표를 삭제하고 메시지를 강제로 새로고침합니다.

`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)`	`Blob`	UTF-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`	이 라벨을 삭제합니다.
`getId()`	`String`	이 라벨의 ID를 가져옵니다.
`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()`	`String`	HTML 형식이 없는 이 메시지의 본문 내용을 가져옵니다.
`getRawContent()`	`String`	이 메시지의 원시 콘텐츠를 가져옵니다.
`getReplyTo()`	`String`	이 메일의 답장받을 주소 (일반적으로 발신자)를 가져옵니다.
`getSubject()`	`String`	이 메시지의 제목을 가져옵니다.
`getThread()`	`GmailThread`	이 메시지가 포함된 대화목록을 가져옵니다.
`getTo()`	`String`	이 메시지의 쉼표로 구분된 수신자를 가져옵니다.
`isDraft()`	`Boolean`	이 메시지가 초안인지 여부를 가져옵니다.
`isInChats()`	`Boolean`	이 메시지가 채팅인지 여부를 가져옵니다.
`isInInbox()`	`Boolean`	이 메일이 받은편지함에 있는지 여부를 가져옵니다.
`isInPriorityInbox()`	`Boolean`	이 메시지가 우선순위 받은편지함에 있으면 `true`를 반환하고, 그렇지 않으면 `false`를 반환합니다.
`isInTrash()`	`Boolean`	이 메일이 휴지통에 있는지 여부를 가져옵니다.
`isStarred()`	`Boolean`	이 메시지가 별표표시되었는지 여부를 가져옵니다.
`isUnread()`	`Boolean`	이 메시지가 읽지 않은 메시지인지 여부를 가져옵니다.
`markRead()`	`GmailMessage`	메일을 읽음으로 표시합니다.
`markUnread()`	`GmailMessage`	메일을 읽지 않음으로 표시합니다.
`moveToTrash()`	`GmailMessage`	메일을 휴지통으로 이동합니다.
`refresh()`	`GmailMessage`	Gmail에서 이 메시지와 연결된 상태를 다시 로드합니다 (라벨, 읽음 상태 등이 변경된 경우 유용함).
`reply(body)`	`GmailMessage`	답장받을 주소를 사용하여 이 메시지의 발신자에게 답장합니다.
`reply(body, options)`	`GmailMessage`	선택적 인수를 사용하여 회신 주소로 이 메시지의 발신자에게 답장합니다.
`replyAll(body)`	`GmailMessage`	회신 주소와 이 메일의 모든 수신자를 사용하여 발신자에게 답장합니다.
`replyAll(body, options)`	`GmailMessage`	선택적 인수를 사용하여 답장 주소와 모든 수신자를 사용하여 이 메시지의 발신자에게 답장합니다.
`star()`	`GmailMessage`	메일에 별표를 표시합니다.
`unstar()`	`GmailMessage`	메일의 별표를 삭제합니다.

`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()`	`GmailThread`	이 스레드와 연결된 상태를 Gmail에서 다시 로드합니다 (라벨, 읽음 상태 등이 변경된 경우 유용함).
`removeLabel(label)`	`GmailThread`	스레드에서 이 라벨을 삭제합니다.
`reply(body)`	`GmailThread`	replyTo 주소를 사용하여 이 대화목록의 마지막 메시지 발신자에게 답장합니다.
`reply(body, options)`	`GmailThread`	선택적 인수를 사용하여 replyTo 주소로 이 대화목록의 마지막 메시지 발신자에게 답장합니다.
`replyAll(body)`	`GmailThread`	발신자 (replyTo 주소 사용)와 이 스레드의 마지막 메시지 수신자 모두에게 답장합니다.
`replyAll(body, options)`	`GmailThread`	선택적 인수를 사용하여 발신자 (`replyTo` 주소 사용)와 이 대화목록의 마지막 메시지 수신자 모두에게 답장합니다.

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

클래스

GmailApp

메서드

GmailAttachment

메서드

GmailDraft

메서드

GmailLabel

메서드

GmailMessage

메서드

GmailThread

메서드

Gmail Service

`GmailApp`

`GmailAttachment`

`GmailDraft`

`GmailLabel`

`GmailMessage`

`GmailThread`