Gmail 대화목록, 메일, 라벨에 대한 액세스를 제공합니다.
메서드
자세한 문서
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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 쉼표로 구분된 이메일 주소 목록 |
subject | String | 이메일 제목 |
body | String | 이메일 본문입니다. |
리턴
GmailDraft
: 새로 생성된 GmailDraft
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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' });
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 수신자의 주소 |
subject | String | 제목 |
body | String | 이메일의 본문입니다. |
options | Object | 아래 나열된 고급 매개변수를 지정하는 JavaScript 객체 |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 설정된 경우 HTML을 렌더링할 수 있는 기기에서 HTML을 대신 사용합니다.
필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 본문 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
리턴
GmailDraft
: 새로 생성된 GmailDraft
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.
-
https://mail.google.com/
참고 항목
createLabel(name)
지정된 이름의 새 사용자 라벨을 만듭니다.
// Creates the label @FOO and logs label: FOO Logger.log("label: " + GmailApp.createLabel("FOO"));
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 새 라벨의 이름 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
label | GmailLabel | 삭제할 라벨 |
리턴
GmailApp
: Gmail 서비스, 체인에 유용한 서비스
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.
-
https://mail.google.com/
참고 항목
getAliases()
Gmail에서 이 계정의 별칭으로 설정된 이메일 목록을 가져옵니다.
'보낸사람'을 사용하여 이러한 별칭에서 메일을 보낼 수 있습니다. 선택적 인수입니다.
// 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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
draftId | String | 가져올 초안의 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()); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 검색할 첫 번째 스레드의 색인 |
max | Integer | 검색할 최대 스레드 수 |
리턴
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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
id | String | 검색할 메시지의 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()); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 가져올 메시지 스레드 |
리턴
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()); } }
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 검색할 메시지 스레드 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 검색할 첫 번째 스레드의 색인 |
max | Integer | 검색할 최대 스레드 수 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 검색할 첫 번째 스레드의 색인 |
max | Integer | 검색할 최대 스레드 수 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 검색할 첫 번째 스레드의 색인 |
max | Integer | 검색할 최대 스레드 수 |
리턴
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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
id | String | 검색할 스레드의 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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 검색할 첫 번째 스레드의 색인 |
max | Integer | 검색할 최대 스레드 수 |
리턴
GmailThread[]
- 휴지통에 있는 Gmail 대화목록의 배열
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.
-
https://mail.google.com/
getUserLabelByName(name)
라벨 이름이 지정된 라벨을 검색합니다.
var labelObject = GmailApp.getUserLabelByName("myLabel");
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 검색할 라벨의 이름 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
message | GmailMessage | 읽음으로 표시할 메일 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
message | GmailMessage | 읽지않음으로 표시할 메시지 |
리턴
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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
messages | GmailMessage[] | 읽음으로 표시할 메시지의 배열 |
리턴
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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
messages | GmailMessage[] | 읽지않음으로 표시할 메시지의 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 중요한 메일로 표시할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 읽음으로 표시할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 중요하지 않은 메일로 표시할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 읽지않음으로 표시할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 중요한 것으로 표시할 스레드의 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 읽음으로 표시할 스레드 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 중요하지 않은 대화로 표시할 스레드 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 읽지않음으로 표시할 스레드 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
message | GmailMessage | 휴지통으로 이동할 메일 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
messages | GmailMessage[] | 휴지통으로 이동할 메일 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 보관처리할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 받은편지함으로 이동할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 스팸함으로 이동할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 휴지통으로 이동할 대화목록 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 보관처리할 대화목록 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 받은편지함으로 이동할 대화목록 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 스팸으로 이동할 대화목록 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 휴지통으로 이동할 스레드 배열 |
리턴
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...
매개변수
이름 | 유형 | 설명 |
---|---|---|
message | GmailMessage | 새로고침할 메시지 |
리턴
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...
매개변수
이름 | 유형 | 설명 |
---|---|---|
messages | GmailMessage[] | 새로고침할 메시지가 |
리턴
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 ...
매개변수
이름 | 유형 | 설명 |
---|---|---|
thread | GmailThread | 새로고침할 스레드입니다. |
리턴
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 ...
매개변수
이름 | 유형 | 설명 |
---|---|---|
threads | GmailThread[] | 새로고침할 스레드 |
리턴
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"');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | Gmail에 입력하는 것과 같은 검색어 |
start | Integer | 시작 스레드의 인덱스 |
max | Integer | 반환할 최대 스레드 수 |
리턴
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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 쉼표로 구분된 이메일 주소 목록 |
subject | String | 이메일 제목 (영문 기준 최대 250자) |
body | String | 이메일 본문입니다. |
리턴
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' });
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 수신자의 주소 |
subject | String | 제목 (영문 기준 최대 250자) |
body | String | 이메일의 본문입니다. |
options | Object | 아래 나열된 고급 매개변수를 지정하는 JavaScript 객체 |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
attachments | BlobSource[] | - 이메일로 보낼 파일의 배열 |
bcc | String | 숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록 |
cc | String | 참조로 추가할 이메일 주소의 쉼표로 구분된 목록 |
from | String | 이메일이 전송되어야 하는 주소이며
getAliases() 에서 반환한 값의 백분율 |
htmlBody | String | 설정된 경우 HTML을 렌더링할 수 있는 기기에서 HTML을 대신 사용합니다.
필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 inlineImages 필드를 추가할 수 있습니다.
이메일에 인라인 이미지가 있는 경우 본문 |
inlineImages | Object | 이미지 키의 매핑을 포함하는 JavaScript 객체
(String )를 이미지 데이터 (BlobSource )로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다. |
name | String | 이메일 발신자의 이름 (기본값: 사용자 이름) |
noReply | Boolean | true 일반 웹 주소로 이메일을 보내야 하는 경우
수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은
Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음 |
replyTo | String | 기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) |
리턴
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 }
매개변수
이름 | 유형 | 설명 |
---|---|---|
accessToken | String | Gmail 부가기능 작업 이벤트 객체에서 가져온 임시 액세스 토큰 |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
message | GmailMessage | 별표표시 메시지 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
messages | GmailMessage[] | 별표표시할 메시지의 배열 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
message | GmailMessage | 별표 삭제 메시지 |
리턴
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
messages | GmailMessage[] | 별표를 삭제할 메시지 배열 |
리턴
GmailApp
: Gmail 서비스, 체인에 유용한 서비스
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.
-
https://mail.google.com/