이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class GmailLabel

사용자의 Gmail 계정에서 사용자가 만든 라벨

메소드

메서드	반환 유형	간략한 설명
`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`	주어진 스레드에서 이 라벨을 삭제하고 스레드를 강제로 새로고침합니다.

자세한 문서

`addToThread(thread)`

이 라벨을 지정된 스레드에 추가하고 스레드를 강제로 새로고침합니다 (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);

매개변수

이름	유형	설명
`thread`	`GmailThread`	라벨을 지정할 대화목록입니다.

Return

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

승인

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

https://mail.google.com/

참고 항목

removeFromThread(thread)

`addToThreads(threads)`

주어진 스레드에 이 라벨을 추가하고 스레드를 강제로 새로고침합니다. 배치당 최대 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);

매개변수

이름	유형	설명
`threads`	`GmailThread[]`	라벨을 지정할 스레드 배열입니다.

Return

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

승인

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

https://mail.google.com/

참고 항목

removeFromThreads(threads)

`deleteLabel()`

이 라벨을 삭제합니다.

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

예외 처리

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

승인

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

https://mail.google.com/

참고 항목

getName()

`getName()`

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

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

Return

String — 라벨의 이름입니다.

승인

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

https://mail.google.com/

`getThreads()`

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

모든 스레드의 크기가 시스템에서 처리할 만큼 너무 크면 이 호출이 실패합니다. 스레드 크기를 알 수 없고 잠재적으로 매우 큰 경우 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/

`getThreads(start, max)`

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

// 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());
}

매개변수

이름	유형	설명
`start`	`Integer`	시작 스레드의 색인입니다.
`max`	`Integer`	반환할 최대 스레드 수입니다.

Return

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

승인

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

https://mail.google.com/

`getUnreadCount()`

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

// 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/

`removeFromThread(thread)`

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

// 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);

매개변수

이름	유형	설명
`thread`	`GmailThread`	대화목록에 라벨이 지정되지 않습니다.

Return

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

승인

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

https://mail.google.com/

참고 항목

addToThread(thread)

`removeFromThreads(threads)`

주어진 스레드에서 이 라벨을 삭제하고 스레드를 강제로 새로고침합니다. 배치당 최대 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);

매개변수

이름	유형	설명
`threads`	`GmailThread[]`	라벨을 지정할 스레드 배열입니다.

Return

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

승인

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

https://mail.google.com/

참고 항목

addToThreads(threads)