Class GmailLabel

GmailLabel

Bir kullanıcının Gmail hesabında kullanıcı tarafından oluşturulan bir etiket.

Yöntemler

YöntemDönüş türüKısa açıklama
addToThread(thread)GmailLabelBu etiketi belirtilen ileti dizisine ekler ve ileti dizisini yenilemeye zorlar (GmailThread.refresh()).
addToThreads(threads)GmailLabelBu etiketi belirtilen ileti dizilerine ekler ve ileti dizilerini yenilenmeye zorlar.
deleteLabel()voidBu etiketi siler.
getName()StringBu etiketin adını alır.
getThreads()GmailThread[]Bu etiketle işaretlenen ileti dizilerini alır.
getThreads(start, max)GmailThread[]Bu etiketle işaretlenmiş bir ileti dizisi aralığını alır.
getUnreadCount()IntegerBu etiketle etiketlenmiş okunmamış ileti dizilerinin sayısını alır.
removeFromThread(thread)GmailLabelBu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisini yenilemeye zorlar.
removeFromThreads(threads)GmailLabelBu etiketi belirtilen ileti dizilerinden kaldırır ve ileti dizilerini yenilenmeye zorlar.

Ayrıntılı belgeler

addToThread(thread)

Bu etiketi belirtilen ileti dizisine ekler ve ileti dizisini yenilemeye zorlar (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);

Parametreler

AdTürAçıklama
threadGmailThreadEtiketlenecek ileti dizisi.

Return

GmailLabel: Zincirleme işlemleri için bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz:


addToThreads(threads)

Bu etiketi belirtilen ileti dizilerine ekler ve ileti dizilerini yenilenmeye zorlar. Şunlar için etiket ekleyebilirsiniz: Grup başına en fazla 100 ileti dizisi.

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

Parametreler

AdTürAçıklama
threadsGmailThread[]Etiketlenecek iş parçacığı dizisi.

Return

GmailLabel: Zincirleme işlemleri için bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz:


deleteLabel()

Bu etiketi siler.

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

Fırlatma

Error: Etiket silinemiyorsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz:


getName()

Bu etiketin adını alır.

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

Return

String: Etiketin adı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getThreads()

Bu etiketle işaretlenen ileti dizilerini alır.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrılar başarısız olur. Konum ileti dizisi boyutu bilinmiyor ve muhtemelen çok büyük. Lütfen getThreads(start, max) kullanarak her bir aramada alınacak ileti dizisi aralıklarını belirtin.

// 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[]: Bu etiketle işaretlenen bir ileti dizisi dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getThreads(start, max)

Bu etiketle işaretlenmiş bir ileti dizisi aralığını alır.

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

Parametreler

AdTürAçıklama
startIntegerBaşlangıç ileti dizisinin dizini.
maxIntegerDöndürülecek maksimum ileti dizisi sayısı.

Return

GmailThread[]: Bu etiketle işaretlenen bir ileti dizisi dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getUnreadCount()

Bu etiketle etiketlenmiş okunmamış ileti dizilerinin sayısını alır.

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

Return

Integer — Okunmamış etiketli ileti dizilerinin sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

removeFromThread(thread)

Bu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisini yenilemeye zorlar.

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

Parametreler

AdTürAçıklama
threadGmailThreadİleti dizisinin etiketi kaldırılmış olmalıdır.

Return

GmailLabel: Zincirleme işlemleri için bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz:


removeFromThreads(threads)

Bu etiketi belirtilen ileti dizilerinden kaldırır ve ileti dizilerini yenilenmeye zorlar. Şunları kaldırabilirsiniz: grup başına en fazla 100 ileti dizisi için etiketler.

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

Parametreler

AdTürAçıklama
threadsGmailThread[]Etiketsiz ileti dizisi dizisi.

Return

GmailLabel: Zincirleme işlemleri için bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz: