Class GmailThread

대화목록에 이 라벨을 추가합니다.

// Add label MyLabel to the first thread in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.addLabel(label);

매개변수

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• removeLabel(label)

이 대화목록의 마지막 메시지 발신자에게 답장 주소를 사용하여 답장하는 초안 메시지를 만듭니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft reply to the message author with an acknowledgement.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('Got your message');

매개변수

리턴

GmailDraft: 새로 생성된 초안 메시지

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

이 대화목록의 마지막 메시지 발신자에게 답장하는 초안 메시지를 답장 주소를 사용하여 만듭니다(인수는 선택사항).

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: 'another@example.com',
});

매개변수

고급 매개변수

리턴

GmailDraft: 새로 생성된 초안 메시지

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

이 대화목록의 마지막 메시지 발신자에게 답장하는 초안 메시지를 작성합니다. 이때 답장 주소와 이 메시지의 모든 수신자를 사용합니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft reply to all recipients (except those bcc'd) of the last email
// in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('Got your message');

매개변수

리턴

GmailDraft: 새로 생성된 초안 메시지

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

이 대화목록의 마지막 메시지 발신자에게 답장하는 초안 메시지를 생성합니다. 이때 답장 주소와 모든 수신자를 사용하며 인수는 선택사항입니다.

이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일 크기 (헤더 포함)는 할당량 제한이 적용됩니다.

// Create a draft reply, using an HTML text body, to all recipients (except
// those bcc'd) of the last email of in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: 'another@example.com',
});

매개변수

고급 매개변수

리턴

GmailDraft: 새로 생성된 초안 메시지

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

대화목록의 첫 번째 메시지의 제목을 가져옵니다.

// Log the subject of the first message in the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getFirstMessageSubject());

리턴

String: 대화목록의 첫 번째 메시지 제목

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• getLastMessageDate()

이 대화목록의 ID를 가져옵니다. 스레드의 ID는 스레드에 포함된 메시지에 따라 다릅니다. 스레드의 특정 메시지에 일관된 ID를 사용하려면 대신 getMessages()[0].getId()를 호출하세요.

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const thread = GmailApp.getThreadById(id);
Logger.log(
    thread.getFirstMessageSubject() === firstThread.getFirstMessageSubject(),
);  // True

리턴

String: 이 대화목록의 ID입니다.

이 스레드에서 사용자가 만든 라벨을 반환합니다.

// Log the names of the labels attached to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

리턴

GmailLabel[]: 이 대화목록의 라벨 배열

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

이 대화목록의 가장 최근 메시지 날짜를 가져옵니다.

// Log the date of the most recent message on the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getLastMessageDate());

리턴

Date: 대화목록의 가장 최근 메시지 날짜입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• getFirstMessageSubject()

대화목록의 메시지 수를 반환합니다.

// Log the number of messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getMessageCount());

리턴

Integer: 대화목록의 메시지 수

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• getMessages()

이 대화목록의 메시지를 가져옵니다.

// Log the subjects of the messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
for (let i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

리턴

GmailMessage[]: 이 대화목록의 Gmail 메일 배열

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• getMessageCount()

이 대화목록의 퍼머링크를 가져옵니다.

이 방법은 받은편지함이 아닌 기존 Gmail 인터페이스에서만 작동합니다.

// Logs the permalink for the first thread in the inbox
const thread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(thread.getPermalink());

리턴

String: 이 대화목록의 퍼머링크입니다.

대화목록에 별표표시된 메시지가 있는지 여부를 반환합니다.

// Log if this thread has starred messages
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`has starred : ${firstThread.hasStarredMessages()}`);

리턴

Boolean: 대화목록에 별표표시된 메시지가 있는 경우 true

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

스레드가 중요로 표시되어 있는지 여부를 반환합니다.

// Log if this thread is marked as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Important? : ${firstThread.isImportant()}`);

리턴

Boolean: 대화목록이 중요로 표시되어 있는지 여부입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

스레드에 채팅 라벨이 지정되어 있는지 여부를 반환합니다.

// Log if this thread is a chat
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in chats? : ${firstThread.isInChats()}`);

리턴

Boolean — 대화목록에 채팅 라벨이 지정된 경우 true

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

스레드가 받은편지함에 있는지 여부를 반환합니다.

// Log if this thread is in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in the inbox? : ${firstThread.isInInbox()}`);

리턴

Boolean: 대화목록이 받은편지함에 있는 경우 true

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

이 대화목록이 우선순위 받은편지함에 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

// Log if this thread is in the priority inbox
const firstThread = GmailApp.getPriorityInboxThreads(0, 1)[0];
Logger.log(`is in priority inbox? ${firstThread.isInPriorityInbox()}`);

리턴

Boolean: 대화목록이 자동분류함에 있는 경우 true

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

대화목록이 스팸으로 표시되는지 여부를 반환합니다.

// Log if this thread is in the spam folder
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Spam? ${firstThread.isInSpam()}`);

리턴

Boolean: 이 대화목록이 스팸으로 표시되는지 여부입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

스레드가 휴지통에 있는지 여부를 반환합니다.

// Log if this thread is in the trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Trashed? ${firstThread.isInTrash()}`);

리턴

Boolean: 스레드가 휴지통에 있는 경우 true

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

스레드에 읽지 않은 메시지가 있는지 여부를 반환합니다.

// Log if this thread is unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Unread? ${firstThread.isUnread()}`);

리턴

Boolean: 읽지 않은 메시지가 있으면 true

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

이 대화목록을 중요 대화목록으로 표시합니다.

// Mark first inbox thread as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markImportant();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• markUnimportant()

이 대화목록을 읽음으로 표시합니다.

// Mark first inbox thread as read
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markRead();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• markUnread()

이 대화목록을 중요하지 않은 것으로 표시합니다.

// Mark first inbox thread as unimportant
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnimportant();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• markImportant()

이 대화목록을 읽지 않음으로 표시합니다.

// Mark first inbox thread as unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnread();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• markRead()

이 대화목록을 보관처리합니다.

// Archive first inbox thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToArchive();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

이 대화목록을 받은편지함으로 이동합니다.

// Move first non-inbox thread to inbox
const firstThread = GmailApp.search('-in:inbox')[0];
firstThread.moveToInbox();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

이 대화목록을 스팸함으로 이동합니다.

// Move first inbox thread to spam
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToSpam();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

이 대화목록을 휴지통으로 이동합니다.

// Move first inbox thread to trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToTrash();

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

Gmail에서 이 대화목록과 연결된 상태를 새로고침합니다 (라벨, 읽기 상태 등이 변경된 경우에 유용).

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
// ...Do something that may take a while here....
firstThread.refresh();  // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

대화목록에서 이 라벨을 삭제합니다.

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

매개변수

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• addLabel(label)

replyTo 주소를 사용하여 이 대화목록의 마지막 메시지 발신자에게 답장합니다.

이메일의 총 크기 (모든 헤더 포함)는 20KB를 초과할 수 없습니다.

// Respond to author of last email in thread with acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('Got your message');

매개변수

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

이 대화목록의 마지막 메시지 발신자에게 replyTo 주소를 사용하여 답장합니다(인수가 선택사항). 이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일의 총 크기 (모든 헤더 포함, 첨부파일 제외)는 20KB를 초과할 수 없습니다.

// Respond with HTML body text.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

매개변수

고급 매개변수

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• reply(body)
• replyAll(body)
• replyAll(body, options)

발신자 (replyTo 주소 사용)와 이 대화목록의 마지막 메시지 수신자 모두에게 답장합니다.

이메일의 총 크기 (모든 헤더 포함)는 20KB를 초과할 수 없습니다.

// Respond to all with acknowledgment to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('Got your message');

매개변수

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• reply(body, options)
• reply(body)
• replyAll(body, options)

발신자 (replyTo 주소 사용) 및 이 대화목록의 마지막 메시지의 모든 수신자에게 선택적 인수를 사용하여 답장합니다. 이메일에는 일반 텍스트와 HTML 본문이 모두 포함될 수 있습니다. 이메일의 총 크기 (모든 헤더 포함, 첨부파일 제외)는 20KB를 초과할 수 없습니다.

// Respond with HTML body text.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

매개변수

고급 매개변수

리턴

GmailThread: 체이닝에 유용한 스레드

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 있는 승인이 필요합니다.

• https://mail.google.com/

참고 항목

• reply(body)
• replyAll(body)
• replyAll(body, options)