Bir 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 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ı 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 dizisini yenilemeye zorlar. |
removeFromThreads(threads) | GmailLabel | Bu etiketi belirtilen 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 yenilemeye 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şlemleri için bu etiket.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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. Şunlar için etiket ekleyebilirsiniz: Grup başına en fazla 100 ileti dizisi.
// 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 iş parçacığı dizisi. |
Return
GmailLabel
: Zincirleme işlemleri için bu etiket.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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();
Fırlatma
Error
: Etiket silinemiyorsa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 bir veya daha fazlasıyla ya da ilgili REST API'sinden 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. Konum
ileti dizisi boyutu bilinmiyor ve muhtemelen çok büyük. Lütfen getThreads(start, max)
kullanarak her bir aramada 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 bir ileti dizisi dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 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ıç ileti dizisinin dizini. |
max | Integer | Döndürülecek maksimum ileti dizisi sayısı. |
Return
GmailThread[]
: Bu etiketle işaretlenen bir ileti dizisi dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 var 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 ya da ilgili REST API'sinden 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 var label = GmailApp.getUserLabelByName("MyLabel"); var firstThread = GmailApp.getInboxThreads(0,1)[0]; label.removeFromThread(firstThread);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
thread | GmailThread | İleti dizisinin etiketi kaldırılmış olmalıdır. |
Return
GmailLabel
: Zincirleme işlemleri için bu etiket.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 dizilerini yenilenmeye zorlar. Şunları kaldırabilirsiniz: grup başına en fazla 100 ileti dizisi için etiketler.
// 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[] | Etiketsiz ileti dizisi dizisi. |
Return
GmailLabel
: Zincirleme işlemleri için bu etiket.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:
-
https://mail.google.com/