Class GmailLabel

이 라벨을 지정된 스레드에 추가하고 스레드를 강제로 새로고침합니다 (GmailThread.refresh()).

// label the first thread in the inbox with the label MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
label.addToThread(firstThread);

매개변수

Return

GmailLabel: 체이닝용 라벨입니다.

승인

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

• https://mail.google.com/

참고 항목

• removeFromThread(thread)

주어진 스레드에 이 라벨을 추가하고 스레드를 강제로 새로고침합니다. 배치당 최대 100개의 스레드에 라벨을 추가할 수 있습니다.

// label the first three threads in the inbox with the label MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = GmailApp.getInboxThreads(0,3);
label.addToThreads(threads);

매개변수

Return

GmailLabel: 체이닝용 라벨입니다.

승인

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

• https://mail.google.com/

참고 항목

• removeFromThreads(threads)

이 라벨을 삭제합니다.

var label = GmailApp.getUserLabelByName("MyLabel");
label.deleteLabel();

예외 처리

Error — 라벨을 삭제할 수 없는 경우

승인

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

• https://mail.google.com/

참고 항목

• getName()

이 라벨의 이름을 가져옵니다.

var label = GmailApp.getUserLabelByName("MyLabel");
Logger.log(label.getName()); //logs MyLabel

Return

String — 라벨의 이름입니다.

승인

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

• https://mail.google.com/

이 라벨이 표시된 스레드를 가져옵니다.

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없고 잠재적으로 매우 큰 경우 getThreads(start, max)를 사용하여 각 호출에서 검색할 스레드 범위를 지정하세요.

// Log the subject lines of the threads labeled with MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = label.getThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Return

GmailThread[]: 이 라벨로 표시된 스레드의 배열입니다.

승인

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

• https://mail.google.com/

이 라벨로 표시된 대화목록의 범위를 가져옵니다.

// log the subject lines of up to the first 30 threads with the label MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = label.getThreads(0, 30);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

매개변수

Return

GmailThread[]: 이 라벨로 표시된 스레드의 배열입니다.

승인

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

• https://mail.google.com/

이 라벨로 태그가 지정된 읽지 않은 대화목록의 개수를 가져옵니다.

// log the number of unread threads labeled with MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
Logger.log(label.getUnreadCount());

Return

Integer — 읽지 않은 라벨이 지정된 대화목록의 수입니다.

승인

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

• https://mail.google.com/

주어진 스레드에서 이 라벨을 삭제하고 스레드를 강제로 새로고침합니다.

// remove the label MyLabel from the first thread in the inbox
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
label.removeFromThread(firstThread);

매개변수

Return

GmailLabel: 체이닝용 라벨입니다.

승인

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

• https://mail.google.com/

참고 항목

• addToThread(thread)

주어진 스레드에서 이 라벨을 삭제하고 스레드를 강제로 새로고침합니다. 배치당 최대 100개의 스레드에 대한 라벨을 삭제할 수 있습니다.

// remove the label MyLabel from the first three threads in the inbox
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = GmailApp.getInboxThreads(0,3);
label.removeFromThreads(threads);

매개변수

Return

GmailLabel: 체이닝용 라벨입니다.

승인

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

• https://mail.google.com/

참고 항목

• addToThreads(threads)