Class GmailApp

GmailApp

Gmail mesaj dizilerine, mesajlarına ve etiketlerine erişim sağlar.

Yöntemler

YöntemDönüş türüKısa açıklama
createDraft(recipient, subject, body)GmailDraftTaslak e-posta iletisi oluşturur.
createDraft(recipient, subject, body, options)GmailDraftİsteğe bağlı bağımsız değişkenler içeren bir e-posta taslağı oluşturur.
createLabel(name)GmailLabelVerilen ada sahip yeni bir kullanıcı etiketi oluşturun.
deleteLabel(label)GmailAppBelirtilen etiketi siler.
getAliases()String[]Gmail'de bu hesap için takma ad olarak ayarlanan e-postaların listesini alır.
getDraft(draftId)GmailDraftKimliğe göre bir e-posta iletisi taslağı alın.
getDraftMessages()GmailMessage[]Tüm taslak iletileri alır.
getDrafts()GmailDraft[]Tüm Gmail taslak iletilerini alır.
getInboxThreads()GmailThread[]Etiketlerden bağımsız olarak tüm gelen kutusu ileti dizilerini alır.
getInboxThreads(start, max)GmailThread[]Etiketlerden bağımsız olarak gelen kutusu ileti dizileri aralığını alır.
getInboxUnreadCount()IntegerGelen kutusundaki okunmamış ileti dizilerinin sayısını alır.
getMessageById(id)GmailMessageKimliğe göre ileti alır.
getMessagesForThread(thread)GmailMessage[]Belirtilen ileti dizisindeki tüm iletileri alın.
getMessagesForThreads(threads)GmailMessage[][]Belirtilen ileti dizilerindeki tüm iletileri alın.
getPriorityInboxThreads()GmailThread[]Etiketlerden bağımsız olarak tüm Öncelikli E-postalar ileti dizilerini alır.
getPriorityInboxThreads(start, max)GmailThread[]Etiketlerden bağımsız olarak bir dizi Öncelikli E-postalar ileti dizisi alır.
getPriorityInboxUnreadCount()IntegerÖncelikli E-postalar'daki okunmamış ileti dizilerinin sayısını alır.
getSpamThreads()GmailThread[]Etiketlerden bağımsız olarak tüm spam ileti dizilerini alır.
getSpamThreads(start, max)GmailThread[]Etiketlerden bağımsız olarak bir dizi spam ileti dizisini alır.
getSpamUnreadCount()IntegerOkunmamış olan ve spam olan ileti dizilerinin sayısını alır.
getStarredThreads()GmailThread[]Etiketlerden bağımsız olarak tüm yıldızlı ileti dizilerini alır.
getStarredThreads(start, max)GmailThread[]Etiketlerden bağımsız olarak bir dizi yıldızlı ileti dizisini alır.
getStarredUnreadCount()IntegerOkunmamış mesaj dizilerinin yıldızlı sayısını alır.
getThreadById(id)GmailThreadKimliğe göre bir ileti dizisini alır.
getTrashThreads()GmailThread[]Etiketlerden bağımsız olarak çöp kutusundaki tüm ileti dizilerini alır.
getTrashThreads(start, max)GmailThread[]Etiketlerden bağımsız olarak bir dizi çöp kutusu ileti dizisi getirir.
getUserLabelByName(name)GmailLabelEtiket adına sahip bir etiketi getirir.
getUserLabels()GmailLabel[]Kullanıcı tarafından oluşturulan etiketlerin bir listesini alır.
markMessageRead(message)GmailAppBu iletiyi okundu olarak işaretler ve iletiyi yenilenmeye zorlar.
markMessageUnread(message)GmailAppBu iletiyi okunmadı olarak işaretler ve iletiyi yenilenmeye zorlar.
markMessagesRead(messages)GmailAppBu iletileri okundu olarak işaretler ve iletileri yenilenmeye zorlar.
markMessagesUnread(messages)GmailAppBu iletileri okunmadı olarak işaretler ve iletileri yenilenmeye zorlar.
markThreadImportant(thread)GmailAppBu ileti dizisini önemli olarak işaretler ve ileti dizisini yenilenmeye zorlar.
markThreadRead(thread)GmailAppBu ileti dizisini okundu olarak işaretler ve ileti dizisini yenilenmeye zorlar.
markThreadUnimportant(thread)GmailAppBu ileti dizisini önemsiz olarak işaretler ve ileti dizisini yenilenmeye zorlar.
markThreadUnread(thread)GmailAppBu ileti dizisini okunmadı olarak işaretler ve ileti dizisini yenilenmeye zorlar.
markThreadsImportant(threads)GmailAppBu ileti dizilerini önemli olarak işaretler ve ileti dizilerini yenilenmeye zorlar.
markThreadsRead(threads)GmailAppBu ileti dizilerini okundu olarak işaretler ve ileti dizilerini yenilenmeye zorlar.
markThreadsUnimportant(threads)GmailAppBu ileti dizilerini önemsiz olarak işaretler ve ileti dizilerini yenilenmeye zorlar.
markThreadsUnread(threads)GmailAppBu ileti dizilerini okunmadı olarak işaretler ve ileti dizilerini yenilenmeye zorlar.
moveMessageToTrash(message)GmailAppİleti çöp kutusuna taşınır ve yenilenmeye zorlanır.
moveMessagesToTrash(messages)GmailAppBelirtilen iletileri çöp kutusuna taşır ve iletileri yenilenmeye zorlar.
moveThreadToArchive(thread)GmailAppBu ileti dizisini arşive taşır ve ileti dizisini yenilenmeye zorlar.
moveThreadToInbox(thread)GmailAppBu ileti dizisini gelen kutusuna taşır ve ileti dizisini yenilenmeye zorlar.
moveThreadToSpam(thread)GmailAppBu ileti dizisini spam'e taşır ve ileti dizisini yenilenmeye zorlar.
moveThreadToTrash(thread)GmailAppBu ileti dizisini çöp kutusuna taşır ve ileti dizisini yenilenmeye zorlar.
moveThreadsToArchive(threads)GmailAppBu ileti dizilerini arşive taşır ve ileti dizilerini yenilenmeye zorlar.
moveThreadsToInbox(threads)GmailAppBu ileti dizilerini gelen kutusuna taşır ve ileti dizilerini yenilenmeye zorlar.
moveThreadsToSpam(threads)GmailAppBu ileti dizilerini spam klasörüne taşır ve ileti dizilerini yenilenmeye zorlar.
moveThreadsToTrash(threads)GmailAppBu ileti dizilerini çöp kutusuna taşır ve ileti dizilerini yenilenmeye zorlar.
refreshMessage(message)GmailAppGmail'den iletiyi ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse yararlıdır).
refreshMessages(messages)GmailAppGmail'den iletileri ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse kullanışlıdır).
refreshThread(thread)GmailAppGmail'den ileti dizisini ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse yararlıdır).
refreshThreads(threads)GmailAppGmail'den ileti dizilerini ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse yararlıdır).
search(query)GmailThread[]Gmail'de ilgili sorguyla arama yapın.
search(query, start, max)GmailThread[]Gmail'de ilgili sorguyla arama yapın.
sendEmail(recipient, subject, body)GmailAppE-posta mesajı gönderir.
sendEmail(recipient, subject, body, options)GmailAppİsteğe bağlı bağımsız değişkenler içeren bir e-posta iletisi gönderir.
setCurrentMessageAccessToken(accessToken)voidKomut dosyasının mevcut GmailMessage özelliklerine erişmesini sağlayan geçerli mesaj erişim jetonunu ayarlar.
starMessage(message)GmailAppBu iletiye yıldız ekler ve iletiyi yenilenmeye zorlar.
starMessages(messages)GmailAppBu iletilere yıldız ekler ve iletileri yenilenmeye zorlar.
unstarMessage(message)GmailAppBu iletiden yıldız kaldırılır ve iletiyi yenilenmeye zorlanır.
unstarMessages(messages)GmailAppBu iletilerden yıldızları kaldırır ve iletileri yenilenmeye zorlar.

Ayrıntılı belgeler

createDraft(recipient, subject, body)

Taslak e-posta iletisi oluşturur. E-postanın boyutu (üstbilgiler dahil) kota sınırlıdır.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());

Parametreler

AdTürAçıklama
recipientStringe-posta adreslerinin virgülle ayrılmış listesi
subjectStringe-postanın konusu
bodyStringe-postanın gövdesi

Return

GmailDraft - yeni oluşturulan GmailDraft

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:


createDraft(recipient, subject, body, options)

İsteğe bağlı bağımsız değişkenler içeren bir e-posta taslağı oluşturur. E-posta düz metin veya bir HTML gövdesi içerebilir. E-postanın boyutu (üstbilgiler dahil ancak ekler hariç) kota sınırlıdır.

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametreler

AdTürAçıklama
recipientStringalıcının adresleri
subjectStringkonu satırı
bodyStringe-postanın gövdesi
optionsObjectaşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[]e-postayla gönderilecek bir dosya dizisi
bccStringBCC'ye e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringe-postanın gönderilmesi gereken adres (getAliases() tarafından döndürülen değerlerden biri olmalıdır)
htmlBodyStringayarlanırsa HTML oluşturabilen cihazlar, gerekli gövde bağımsız değişkeni yerine bunu kullanır. E-postanızda satır içi resimler varsa HTML gövdesine isteğe bağlı bir inlineImages alanı ekleyebilirsiniz
inlineImagesObjectresim anahtarından (String) resim verilerine (BlobSource) eşleme içeren bir JavaScript nesnesi; htmlBody parametresinin kullanıldığı varsayılır ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerir.
nameStringe-postayı gönderenin adı (varsayılan: kullanıcının adı)
replyToStringvarsayılan yanıt adresi olarak kullanılacak bir e-posta adresi (varsayılan: kullanıcının e-posta adresi)

Return

GmailDraft - yeni oluşturulan GmailDraft

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:


createLabel(name)

Verilen ada sahip yeni bir kullanıcı etiketi oluşturun.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

Parametreler

AdTürAçıklama
nameStringyeni etiketin adı

Return

GmailLabel - yeni oluşturulan etiket

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(label)

Belirtilen etiketi siler.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

Parametreler

AdTürAçıklama
labelGmailLabelsilinecek etiket

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


getAliases()

Gmail'de bu hesap için takma ad olarak ayarlanan e-postaların listesini alır.

İsteğe bağlı "from" bağımsız değişkenini kullanarak bu takma adların herhangi birinden ileti gönderebilirsiniz.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

Return

String[]: Bu hesaba yönelik bir takma ad 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/

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


getDraft(draftId)

Kimliğe göre bir e-posta iletisi taslağı alın.

Bunu Gmail taslaklarında getId() ile birlikte kullanın.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Parametreler

AdTürAçıklama
draftIdStringalınacak taslağın kimliği

Return

GmailDraft - Verilen kimliğe sahip taslak

Dekoratif yastıklar

Error: Belirtilen kimliğe sahip taslak bulunamazsa

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/

getDraftMessages()

Tüm taslak iletileri alır.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

Return

GmailMessage[]: Taslak Gmail iletileri 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/

getDrafts()

Tüm Gmail taslak iletilerini alır.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

Return

GmailDraft[]: Gmail taslak iletileri 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/

getInboxThreads()

Etiketlerden bağımsız olarak tüm gelen kutusu ileti dizilerini alır.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olursa bu çağrı başarısız olur. İş parçacığı boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen "sayfalı" çağrısını kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Return

GmailThread[]: Gelen kutusundaki Gmail ileti 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/

getInboxThreads(start, max)

Etiketlerden bağımsız olarak gelen kutusu ileti dizileri aralığını alır.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Parametreler

AdTürAçıklama
startIntegerilk iş parçacığının dizini
maxIntegeralınabilecek maksimum ileti dizisi sayısı

Return

GmailThread[]: Gelen kutusundaki Gmail ileti 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/

getInboxUnreadCount()

Gelen kutusundaki okunmamış ileti dizilerinin sayısını alır.

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

Return

Integer: Gelen kutusunda okunmamış iletiler olan ileti 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/

getMessageById(id)

Kimliğe göre ileti alır.

Bunu Gmail iletilerinde getId() ile birlikte kullanın.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

Parametreler

AdTürAçıklama
idStringgeri alınacak mesajın kimliği

Return

GmailMessage - belirtilen kimliğe sahip ileti

Dekoratif yastıklar

Error - Belirtilen kimliğe sahip ileti bulunamazsa

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:


getMessagesForThread(thread)

Belirtilen ileti dizisindeki tüm iletileri alın.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

Parametreler

AdTürAçıklama
threadGmailThreadalmak için ileti dizisinden

Return

GmailMessage[]: Bu ileti dizisine karşılık gelen mesaj 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/

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


getMessagesForThreads(threads)

Belirtilen ileti dizilerindeki tüm iletileri alın.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

Parametreler

AdTürAçıklama
threadsGmailThread[]alınabilecek mesaj dizileri

Return

GmailMessage[][]: Dış dizideki her öğenin bir ileti dizisine karşılık geldiği, iç dizinin ise ilgili ileti dizisindeki mesajları içerdiği bir mesaj dizisidir

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:


getPriorityInboxThreads()

Etiketlerden bağımsız olarak tüm Öncelikli E-postalar ileti dizilerini alır.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olursa bu çağrı başarısız olur. İş parçacığı boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen "sayfalı" çağrısını kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

Return

GmailThread[]: Öncelikli E-postalar'daki bir Gmail ileti 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/

getPriorityInboxThreads(start, max)

Etiketlerden bağımsız olarak bir dizi Öncelikli E-postalar ileti dizisi alır.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

Parametreler

AdTürAçıklama
startIntegerilk iş parçacığının dizini
maxIntegeralınabilecek maksimum ileti dizisi sayısı

Return

GmailThread[]: Öncelikli E-postalar'daki bir Gmail ileti 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/

getPriorityInboxUnreadCount()

Öncelikli E-postalar'daki okunmamış ileti dizilerinin sayısını alır.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

Return

Integer: Öncelikli E-postalar'da okunmamış iletiler içeren ileti 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/

getSpamThreads()

Etiketlerden bağımsız olarak tüm spam ileti dizilerini alır.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olursa bu çağrı başarısız olur. İş parçacığı boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen "sayfalı" çağrısını kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

Return

GmailThread[]: Spam klasöründeki Gmail mesaj dizileri

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/

getSpamThreads(start, max)

Etiketlerden bağımsız olarak bir dizi spam ileti dizisini alır.

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

Parametreler

AdTürAçıklama
startIntegerilk iş parçacığının dizini
maxIntegeralınabilecek maksimum ileti dizisi sayısı

Return

GmailThread[]: Spam klasöründeki Gmail mesaj dizileri

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/

getSpamUnreadCount()

Okunmamış olan ve spam olan ileti dizilerinin sayısını alır.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

Return

Integer — Okunmamış mesajları olan spam 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/

getStarredThreads()

Etiketlerden bağımsız olarak tüm yıldızlı ileti dizilerini alır.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olursa bu çağrı başarısız olur. İş parçacığı boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen "sayfalı" çağrısını kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

Return

GmailThread[]: Yıldızlı Gmail ileti 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/

getStarredThreads(start, max)

Etiketlerden bağımsız olarak bir dizi yıldızlı ileti dizisini alır.

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

Parametreler

AdTürAçıklama
startIntegerilk iş parçacığının dizini
maxIntegeralınabilecek maksimum ileti dizisi sayısı

Return

GmailThread[]: Yıldızlı Gmail ileti 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/

getStarredUnreadCount()

Okunmamış mesaj dizilerinin yıldızlı sayısını alır.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

Return

Integer - Okunmamış mesajları olan yıldızlı 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/

getThreadById(id)

Kimliğe göre bir ileti dizisini alır.

Bunu Gmail ileti dizilerinde getId() ile birlikte kullanın.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

Parametreler

AdTürAçıklama
idStringAlınacak iş parçacığının kimliği.

Return

GmailThread: Belirtilen kimliğe veya null bulunamazsa sahip olan ileti 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/

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


getTrashThreads()

Etiketlerden bağımsız olarak çöp kutusundaki tüm ileti dizilerini alır.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olursa bu çağrı başarısız olur. İş parçacığı boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen "sayfalı" çağrısını kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

Return

GmailThread[]: Çöp kutusundaki Gmail ileti 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/

getTrashThreads(start, max)

Etiketlerden bağımsız olarak bir dizi çöp kutusu ileti dizisi getirir.

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

Parametreler

AdTürAçıklama
startIntegerilk iş parçacığının dizini
maxIntegeralınabilecek maksimum ileti dizisi sayısı

Return

GmailThread[]: Çöp kutusundaki Gmail ileti 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/

getUserLabelByName(name)

Etiket adına sahip bir etiketi getirir.

var labelObject = GmailApp.getUserLabelByName("myLabel");

Parametreler

AdTürAçıklama
nameStringetiketin adı

Return

GmailLabel: Verilen ada sahip Gmail etiketi

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/

getUserLabels()

Kullanıcı tarafından oluşturulan etiketlerin bir listesini alır.

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

Return

GmailLabel[]: Kullanıcı tarafından oluşturulan etiketler 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/

markMessageRead(message)

Bu iletiyi okundu olarak işaretler ve iletiyi yenilenmeye zorlar.

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

Parametreler

AdTürAçıklama
messageGmailMessageokundu olarak işaretlenecek mesaj

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markMessageUnread(message)

Bu iletiyi okunmadı olarak işaretler ve iletiyi yenilenmeye zorlar.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

Parametreler

AdTürAçıklama
messageGmailMessageokunmadı olarak işaretlenecek mesaj

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markMessagesRead(messages)

Bu iletileri okundu olarak işaretler ve iletileri yenilenmeye zorlar.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

Parametreler

AdTürAçıklama
messagesGmailMessage[]Okundu olarak işaretlenecek mesaj dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markMessagesUnread(messages)

Bu iletileri okunmadı olarak işaretler ve iletileri yenilenmeye zorlar.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

Parametreler

AdTürAçıklama
messagesGmailMessage[]okunmadı olarak işaretlenecek bir mesaj dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadImportant(thread)

Bu ileti dizisini önemli olarak işaretler ve ileti dizisini yenilenmeye zorlar.

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

Parametreler

AdTürAçıklama
threadGmailThreadönemli olarak işaretlenecek ileti dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadRead(thread)

Bu ileti dizisini okundu olarak işaretler ve ileti dizisini yenilenmeye zorlar.

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Parametreler

AdTürAçıklama
threadGmailThreadokundu olarak işaretlenecek ileti dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadUnimportant(thread)

Bu ileti dizisini önemsiz olarak işaretler ve ileti dizisini yenilenmeye zorlar.

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

Parametreler

AdTürAçıklama
threadGmailThreadönemsiz olarak işaretlenecek ileti dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadUnread(thread)

Bu ileti dizisini okunmadı olarak işaretler ve ileti dizisini yenilenmeye zorlar.

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Parametreler

AdTürAçıklama
threadGmailThreadokunmadı olarak işaretlenecek ileti dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadsImportant(threads)

Bu ileti dizilerini önemli olarak işaretler ve ileti dizilerini yenilenmeye zorlar.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

Parametreler

AdTürAçıklama
threadsGmailThread[]önemli olarak işaretlenecek ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadsRead(threads)

Bu ileti dizilerini okundu olarak işaretler ve ileti dizilerini yenilenmeye zorlar.

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

Parametreler

AdTürAçıklama
threadsGmailThread[]okundu olarak işaretlenecek ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadsUnimportant(threads)

Bu ileti dizilerini önemsiz olarak işaretler ve ileti dizilerini yenilenmeye zorlar.

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

Parametreler

AdTürAçıklama
threadsGmailThread[]önemsiz olarak işaretlenecek ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


markThreadsUnread(threads)

Bu ileti dizilerini okunmadı olarak işaretler ve ileti dizilerini yenilenmeye zorlar.

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Parametreler

AdTürAçıklama
threadsGmailThread[]okunmadı olarak işaretlenecek ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveMessageToTrash(message)

İleti çöp kutusuna taşınır ve yenilenmeye zorlanır.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Parametreler

AdTürAçıklama
messageGmailMessageileti çöp kutusuna gönderilecek

Return

GmailApp - Gmail hizmeti (zincirleme için kullanışlıdır)

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:


moveMessagesToTrash(messages)

Belirtilen iletileri çöp kutusuna taşır ve iletileri yenilenmeye zorlar.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

Parametreler

AdTürAçıklama
messagesGmailMessage[]çöp kutusuna gönderilecek iletiler

Return

GmailApp - Gmail hizmeti (zincirleme için kullanışlıdır)

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:


moveThreadToArchive(thread)

Bu ileti dizisini arşive taşır ve ileti dizisini yenilenmeye zorlar.

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

Parametreler

AdTürAçıklama
threadGmailThreadarşivlenecek ileti dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadToInbox(thread)

Bu ileti dizisini gelen kutusuna taşır ve ileti dizisini yenilenmeye zorlar.

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

Parametreler

AdTürAçıklama
threadGmailThreadileti dizisi gelen kutusuna taşınacak

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadToSpam(thread)

Bu ileti dizisini spam'e taşır ve ileti dizisini yenilenmeye zorlar.

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

Parametreler

AdTürAçıklama
threadGmailThreadileti dizisi spam'e taşınacak

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadToTrash(thread)

Bu ileti dizisini çöp kutusuna taşır ve ileti dizisini yenilenmeye zorlar.

// Move first thread in inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToTrash(firstThread);

Parametreler

AdTürAçıklama
threadGmailThreadileti dizisi çöp kutusuna gönderilecek

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadsToArchive(threads)

Bu ileti dizilerini arşive taşır ve ileti dizilerini yenilenmeye zorlar.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

Parametreler

AdTürAçıklama
threadsGmailThread[]arşivlenecek ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadsToInbox(threads)

Bu ileti dizilerini gelen kutusuna taşır ve ileti dizilerini yenilenmeye zorlar.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Parametreler

AdTürAçıklama
threadsGmailThread[]gelen kutusuna taşınacak ileti dizileri dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadsToSpam(threads)

Bu ileti dizilerini spam klasörüne taşır ve ileti dizilerini yenilenmeye zorlar.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

Parametreler

AdTürAçıklama
threadsGmailThread[]spam'e taşınacak ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


moveThreadsToTrash(threads)

Bu ileti dizilerini çöp kutusuna taşır ve ileti dizilerini yenilenmeye zorlar.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Parametreler

AdTürAçıklama
threadsGmailThread[]çöp kutusuna gönderilecek ileti dizisi dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


refreshMessage(message)

Gmail'den iletiyi ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse yararlıdır).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

Parametreler

AdTürAçıklama
messageGmailMessageyenilenecek mesaj

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


refreshMessages(messages)

Gmail'den iletileri ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse kullanışlıdır).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

Parametreler

AdTürAçıklama
messagesGmailMessage[]yenilenecek iletiler

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


refreshThread(thread)

Gmail'den ileti dizisini ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse yararlıdır).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

Parametreler

AdTürAçıklama
threadGmailThreadyenilenecek ileti dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


refreshThreads(threads)

Gmail'den ileti dizilerini ve ilişkili durumu yeniden yükler (etiketler, okuma durumu vb. değiştiyse yararlıdır).

var threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

Parametreler

AdTürAçıklama
threadsGmailThread[]yenilenecek ileti dizileri

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


search(query)

Gmail'de ilgili sorguyla arama yapın.

Tüm ileti dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olursa bu çağrı başarısız olur. İş parçacığı boyutunun bilinmediği ve potansiyel olarak çok büyük olduğu durumlarda lütfen "sayfalı" çağrısını kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

Parametreler

AdTürAçıklama
queryStringGmail'e yazdığınız gibi, arama sorgusunu

Return

GmailThread[]: Bu sorguyla eşleşen Gmail 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/

search(query, start, max)

Gmail'de ilgili sorguyla arama yapın.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Parametreler

AdTürAçıklama
queryStringGmail'e yazdığınız gibi, arama sorgusunu
startIntegerbaşlangıç iş parçacığının dizini
maxIntegerdöndürülecek maksimum ileti dizisi sayısı

Return

GmailThread[]: Bu sorguyla eşleşen Gmail 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/

sendEmail(recipient, subject, body)

E-posta mesajı gönderir. E-postanın boyutu (üstbilgiler dahil) kota sınırlıdır.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("mike@example.com", "current time", "The time is: " + now.toString());

Parametreler

AdTürAçıklama
recipientStringe-posta adreslerinin virgülle ayrılmış listesi
subjectStringe-postanın konusu (maksimum 250 karakter)
bodyStringe-postanın gövdesi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


sendEmail(recipient, subject, body, options)

İsteğe bağlı bağımsız değişkenler içeren bir e-posta iletisi gönderir. E-posta düz metin veya HTML gövdesi içerebilir. E-postanın boyutu (üstbilgiler dahil ancak ekler hariç) kota sınırlıdır.

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('mike@example.com', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametreler

AdTürAçıklama
recipientStringalıcının adresleri
subjectStringkonu satırı (maksimum 250 karakter)
bodyStringe-postanın gövdesi
optionsObjectaşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[]e-postayla gönderilecek bir dosya dizisi
bccStringBCC'ye e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringe-postanın gönderilmesi gereken adres (getAliases() tarafından döndürülen değerlerden biri olmalıdır)
htmlBodyStringayarlanırsa HTML oluşturabilen cihazlar, gerekli gövde bağımsız değişkeni yerine bunu kullanır. E-postanızda satır içi resimler varsa HTML gövdesine isteğe bağlı bir inlineImages alanı ekleyebilirsiniz
inlineImagesObjectresim anahtarından (String) resim verilerine (BlobSource) eşleme içeren bir JavaScript nesnesi; htmlBody parametresinin kullanıldığı varsayılır ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerir.
nameStringe-postayı gönderenin adı (varsayılan: kullanıcının adı)
noReplyBooleanE-postanın, alıcıların e-postaları yanıtlamasını caydırmak amacıyla genel bir yanıt kabul etmeyen e-posta adresinden gönderilmesi gerekiyorsa true; bu seçenek yalnızca Google Workspace hesapları için geçerlidir, Gmail kullanıcıları için mümkün değildir
replyToStringvarsayılan yanıt adresi olarak kullanılacak bir e-posta adresi (varsayılan: kullanıcının e-posta adresi)

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


setCurrentMessageAccessToken(accessToken)

Komut dosyasının mevcut GmailMessage özelliklerine erişmesini sağlayan geçerli mesaj erişim jetonunu ayarlar.

Bu yöntem yalnızca Gmail'in geçerli mesaj kapsamlarını kullanan Google Workspace Eklentisi projeleri için gereklidir.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

Parametreler

AdTürAçıklama
accessTokenStringGmail eklentisi işlem etkinliği nesnesinden alınan geçici erişim jetonu.

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/

starMessage(message)

Bu iletiye yıldız ekler ve iletiyi yenilenmeye zorlar.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

Parametreler

AdTürAçıklama
messageGmailMessageyıldız eklenecek mesaj

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


starMessages(messages)

Bu iletilere yıldız ekler ve iletileri yenilenmeye zorlar.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Parametreler

AdTürAçıklama
messagesGmailMessage[]yıldız eklenecek mesaj dizisi

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


unstarMessage(message)

Bu iletiden yıldız kaldırılır ve iletiyi yenilenmeye zorlanır.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Parametreler

AdTürAçıklama
messageGmailMessageyıldızını kaldırmak için gönderilen mesaj

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:


unstarMessages(messages)

Bu iletilerden yıldızları kaldırır ve iletileri yenilenmeye zorlar.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

Parametreler

AdTürAçıklama
messagesGmailMessage[]yıldızı kaldırılacak bir dizi mesaj

Return

GmailApp — Gmail hizmeti; zincirleme bağlantı için kullanışlıdır

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:

Kullanımdan kaldırılan yöntemler