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 |
---|---|---|
add | Gmail | Bu etiketi belirtilen ileti dizisine ekler ve ileti dizisinin yenilenmesini zorlar (Gmail ). |
add | Gmail | Bu etiketi belirtilen iş parçacıklarına ekler ve iş parçacıklarının yenilenmesini zorlar. |
delete | void | Bu etiketi siler. |
get | String | Bu etiketin kimliğini alır. |
get | String | Bu etiketin adını alır. |
get | Gmail | Bu etiketle işaretlenen ileti dizilerini alır. |
get | Gmail | Bu etiketle işaretlenmiş bir ileti dizisi aralığını alır. |
get | Integer | Bu etiketle etiketlenmiş okunmamış ileti dizilerinin sayısını alır. |
remove | Gmail | Bu etiketi belirtilen ileti dizisinden kaldırır ve ileti dizisinin yenilenmesini zorlar. |
remove | Gmail | Bu etiketi belirtilen ileti dizilerinden kaldırır ve ileti dizilerinin yenilenmesini zorlar. |
Ayrıntılı belgeler
add To Thread(thread)
Bu etiketi belirtilen ileti dizisine ekler ve ileti dizisinin yenilenmesini zorlar (Gmail
).
// 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 | Gmail | Etiketlenecek ileti dizisi. |
Return
Gmail
: 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:
add To Threads(threads)
Bu etiketi belirtilen iş parçacıklarına ekler ve iş parçacıklarının yenilenmesini zorlar. Toplu işlem başına 100'e kadar ileti dizisine 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 | Gmail | Etiketlenecek ileti dizileri dizisi. |
Return
Gmail
: 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:
delete Label()
Bu etiketi siler.
const label = GmailApp.getUserLabelByName('MyLabel'); label.deleteLabel();
Battaniyeler
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:
get Id()
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/
get Name()
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/
get Threads()
Bu etiketle işaretlenen 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. İş parçacığı boyutunun bilinmediği ve muhtemelen çok büyük olduğu durumlarda lütfen get
kullanın ve her çağrıda alınacak iş parçacığı 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
Gmail
: 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/
get Threads(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
Gmail
: 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/
get Unread Count()
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/
remove From Thread(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 | Gmail | İleti dizisinin etiketi kaldırılır. |
Return
Gmail
: 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:
remove From Threads(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 | Gmail | Etiketi kaldırılacak ileti dizilerinin dizisi. |
Return
Gmail
: 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/