Bir 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 dizisini yenilenmeye zorlar (GmailThread.refresh() ). |
addToThreads(threads) | GmailLabel | Bu etiketi belirtilen ileti dizilerine ekler ve ileti dizilerini yenilenmeye zorlar. |
deleteLabel() | void | Bu etiketi siler. |
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 ileti dizisi aralığını getirir. |
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 yenilenmeye zorlar. |
removeFromThreads(threads) | GmailLabel | Bu 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
Ad | Tür | Açıklama |
---|---|---|
thread | GmailThread | Etiketlenecek 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
Ad | Tür | Açıklama |
---|---|---|
threads | GmailThread[] | 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
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Başlangıç iş parçacığının dizini. |
max | Integer | Dö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
Ad | Tür | Açıklama |
---|---|---|
thread | GmailThread | İ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
Ad | Tür | Açıklama |
---|---|---|
threads | GmailThread[] | 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/