Class GmailLabel

GmailLabel

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

Yöntemler

YöntemDönüş türüKısa açıklama
addToThread(thread)GmailLabelBu etiketi belirtilen ileti dizisine ekler ve ileti dizisini yenilenmeye 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ı getirir.
getUnreadCount()IntegerBu etiketle etiketlenen okunmamış ileti dizilerinin sayısını alır.
removeFromThread(thread)GmailLabelBu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisini yenilenmeye zorlar.
removeFromThreads(threads)GmailLabelBu etiketi verilen 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 yenilenmeye 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çin bu etikettir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den 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. Grup başına en fazla 100 iş parçacığı için etiket ekleyebilirsiniz.

// 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 ileti dizisi dizisi.

Return

GmailLabel: Zincirleme için bu etikettir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den 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();

Dekoratif yastıklar

Error - Etiket silinemiyorsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den 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 en az biriyle ya da ilgili REST API'den 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. İleti dizisi boyutunun bilinmediği ve büyük olasılıkla çok büyük olabileceği durumlarda lütfen getThreads(start, max) kullanın ve her bir çağrıda 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 mesaj dizileri dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getThreads(start, max)

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

// 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ıç iş parçacığının dizini.
maxIntegerDöndürülecek maksimum ileti dizisi sayısı.

Return

GmailThread[]: Bu etiketle işaretlenen mesaj dizileri dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getUnreadCount()

Bu etiketle etiketlenen 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ış olarak etiketlenmiş mesaj dizilerinin sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

removeFromThread(thread)

Bu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisini yenilenmeye 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 dizisi etiketlenmemiş olmalıdır.

Return

GmailLabel: Zincirleme için bu etikettir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

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


removeFromThreads(threads)

Bu etiketi verilen ileti dizilerinden kaldırır ve ileti dizilerini yenilenmeye zorlar. Grup başına en fazla 100 iş parçacığı için etiketleri kaldırabilirsiniz.

// 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[]Etiketlenmeyecek iş parçacığı dizisi.

Return

GmailLabel: Zincirleme için bu etikettir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

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