이 페이지는 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`	이 라벨을 삭제합니다.
`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`	회신 주소를 사용하여 이 대화목록에서 마지막 메시지의 발신자에게 답장합니다.
`reply(body, options)`	`GmailThread`	선택적 인수를 사용하여 답장 주소를 사용하여 이 스레드의 마지막 메시지의 발신자에게 답장을 보냅니다.
`replyAll(body)`	`GmailThread`	보낸사람 (답장 주소 사용)과 이 대화목록에서 마지막 메시지의 모든 수신자에게 답장합니다.
`replyAll(body, options)`	`GmailThread`	발신자 (`replyTo` 주소 사용)와 이 스레드의 마지막 메시지의 모든 수신자에게 선택적 인수를 사용하여 답장합니다.