이 페이지는 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`	이 블롭이 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`	이 블롭의 이름을 설정합니다.

`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`	reply-to 주소를 사용하여 이 메일의 발신자에게 답장하는 초안 메시지를 만듭니다.
`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` 주소 사용) 및 이 대화목록의 마지막 메시지의 모든 수신자에게 선택적 인수를 사용하여 답장합니다.