Class GmailLabel

GmailEtiketi

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 dizisinin yenilenmesini zorlar (GmailThread.refresh()).
addToThreads(threads)GmailLabelBu etiketi belirtilen iş parçacıklarına ekler ve iş parçacıklarının yenilenmesini zorlar.
deleteLabel()voidBu etiketi siler.
getId()StringBu etiketin kimliğini alır.
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 dizisinin yenilenmesini zorlar.
removeFromThreads(threads)GmailLabelBu etiketi belirtilen ileti dizilerinden kaldırır ve ileti dizilerinin yenilenmesini zorlar.

Ayrıntılı belgeler

addToThread(thread)

Bu etiketi belirtilen ileti dizisine ekler ve ileti dizisinin yenilenmesini zorlar (GmailThread.refresh()).

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

Parametreler

AdTürAçıklama
threadGmailThreadEtiketlenecek ileti dizisi.

Return

GmailLabel: Zincirleme için kullanılan bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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 iş parçacıklarına ekler ve iş parçacıklarının yenilenmesini zorlar. Toplu işlem başına 100'e kadar ileti dizisine etiket ekleyebilirsiniz.

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

Parametreler

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

Return

GmailLabel: Zincirleme için kullanılan bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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.

const label = GmailApp.getUserLabelByName('MyLabel');
label.deleteLabel();

Battaniyeler

Error: Etiket silinemiyorsa

Yetkilendirme

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

  • https://mail.google.com/

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


getId()

Bu etiketin kimliğini alır.

const label = GmailApp.getUserLabelByName('MyLabel');
console.log(label.getId());

Return

String — Etiketin kimliği.

Yetkilendirme

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

  • https://mail.google.com/

getName()

Bu etiketin adını alır.

const 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 biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getThreads()

Bu etiketle işaretlenen ileti dizilerini alır.

Bu aramalar, tüm iş parçacıklarının boyutu sistemin işleyebileceğinden çok büyük olduğunda başarısız olur. İş parçacığı boyutunun bilinmediği ve muhtemelen çok büyük olduğu durumlarda lütfen getThreads(start, max) kullanın ve her çağrıda alınacak iş parçacığı aralıklarını belirtin.

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

Return

GmailThread[]: Bu etiketle işaretlenmiş ileti dizilerinin dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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ı alır.

// log the subject lines of up to the first 30 threads with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = label.getThreads(0, 30);
for (let 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şaretlenmiş ileti dizilerinin dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den 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
const 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 biri veya daha fazlası 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 dizisinin yenilenmesini zorlar.

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

Parametreler

AdTürAçıklama
threadGmailThreadİleti dizisinin etiketi kaldırılır.

Return

GmailLabel: Zincirleme için kullanılan bu etiket.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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 belirtilen ileti dizilerinden kaldırır ve ileti dizilerinin yenilenmesini zorlar. Tek seferde en fazla 100 ileti dizisinin etiketini kaldırabilirsiniz.

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

Parametreler

AdTürAçıklama
threadsGmailThread[]Etiketi kaldırılacak ileti dizilerinin dizisi.

Return

GmailLabel: Zincirleme için kullanılan bu etiket.

Yetkilendirme

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

  • https://mail.google.com/

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