Class GmailLabel

GmailLabel

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

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addToThread(thread)	GmailLabel	Bu etiketi belirtilen ileti dizisine ekler ve ileti dizisinin yenilenmesini zorlar (GmailThread.refresh()).
addToThreads(threads)	GmailLabel	Bu etiketi belirtilen ileti dizilerine ekler ve ileti dizilerinin yenilenmesini zorlar.
deleteLabel()	void	Bu etiketi siler.
getId()	String	Bu etiketin kimliğini alır.
getName()	String	Bu etiketin adını alır.
getThreads()	GmailThread[]	Bu etiketle işaretlenmiş ileti dizilerini alır.
getThreads(start, max)	GmailThread[]	Bu etiketle işaretlenmiş bir ileti dizisi aralığını alır.
getUnreadCount()	Integer	Bu etiketle etiketlenmiş okunmamış ileti dizilerinin sayısını alır.
removeFromThread(thread)	GmailLabel	Bu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisinin yenilenmesini zorlar.
removeFromThreads(threads)	GmailLabel	Bu 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

Ad	Tür	Açıklama
thread	GmailThread	Etiketlenecek 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:

• removeFromThread(thread)

---

addToThreads(threads)

Bu etiketi belirtilen ileti dizilerine ekler ve ileti dizilerinin yenilenmesini zorlar. Toplu işlem başına 100 işleme kadar 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

Ad	Tür	Açıklama
threads	GmailThread[]	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:

• removeFromThreads(threads)

---

deleteLabel()

Bu etiketi siler.

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

Verdiği hatalar

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:

• getName()

---

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şaretlenmiş 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. İleti dizisi boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen getThreads(start, max) kullanın ve her çağrıda alınacak ileti dizilerinin 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

Ad	Tür	Açıklama
start	Integer	Başlangıç ileti dizisinin dizini.
max	Integer	Dö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

Ad	Tür	Açıklama
thread	GmailThread	İ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:

• addToThread(thread)

---

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

Ad	Tür	Açıklama
threads	GmailThread[]	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:

• addToThreads(threads)