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. |
getId() | String | Bu etiketin kimliğini alır. |
getName() | String | Bu etiketin adını alır. |
getThreads() | GmailThread[] | Bu etiketle işaretlenen ileti dizilerini alır. |
getThreads(start, max) | GmailThread[] | Bu etiketle işaretlenmiş bir mesaj 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:
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:
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:
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 bir veya daha fazlasıyla veya ilgili REST API'deki 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://mail.google.com/
getThreads()
Bu etiketle işaretlenen ileti dizilerini alır.
Tüm iş parçacıklarının boyutu sistemin işleyemeyeceği 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ş 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 mesaj 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ş 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 | İleti 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:
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/