Class GmailLabel

GmailEtiket

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

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addToThread(thread)	GmailLabel	Bu etiketi belirtilen ileti dizisine ekler ve ileti dizisini yenilemeye zorlar (GmailThread.refresh()).
addToThreads(threads)	GmailLabel	Bu etiketi belirtilen ileti dizilerine ekler ve ileti dizilerinin yenilenmesini zorlar.
deleteLabel()	void	Bu etiketi siler.
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ığı alır.
getUnreadCount()	Integer	Bu etiketle etiketlenen okunmamış ileti dizilerinin sayısını alır.
removeFromThread(thread)	GmailLabel	Bu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisini yenilemeye zorlar.
removeFromThreads(threads)	GmailLabel	Bu etiketi belirtilen ileti dizilerinden kaldırır ve ileti dizilerinin yenilenmesini zorlar.

Ayrıntılı dokümanlar

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
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 bir veya daha fazlasıyla veya ilgili REST API'deki 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. Her grup için en fazla 100 ileti dizisi etiketi 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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();

Atışlar

Error: Etiket silinemiyorsa

Yetkilendirme

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

• https://mail.google.com/

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

• getName()

---

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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

• https://mail.google.com/

---

getThreads()

Bu etiketle işaretlenmiş ileti dizilerini alır.

Tüm iş parçacıklarının boyutu sistemin kaldıramayacağı kadar büyük olduğunda bu çağrılar başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen getThreads(start, max) kullanın ve her çağrıda alınacak ileti dizisi 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ş bir mesaj dizileri dizisi.

Yetkilendirme

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

• https://mail.google.com/

---

getThreads(start, max)

Bu etiketle işaretlenmiş bir ileti dizisi aralığı 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 mesaj dizisi sayısı.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
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 bir veya daha fazlasıyla veya ilgili REST API'deki 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
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
label.removeFromThread(firstThread);

Parametreler

Ad	Tür	Açıklama
thread	GmailThread	Mesaj dizisi etiketsiz olmalıdır.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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. Grup başına en fazla 100 ileti dizisinin etiketlerini 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[]	Etiketlenmeyecek ileti dizileri dizisi.

Return

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

Yetkilendirme

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

• https://mail.google.com/

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

• addToThreads(threads)