Class GmailApp

GmailUygulaması

Gmail ileti dizilerine, iletilerine ve etiketlerine erişim sağlar.

Yöntemler

YöntemDönüş türüKısa açıklama
createDraft(recipient, subject, body)GmailDraftE-posta mesajı taslağı 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)GmailLabelBelirtilen adla 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 e-posta ileti taslağı alın.
getDraftMessages()GmailMessage[]Tüm taslak iletileri alır.
getDrafts()GmailDraft[]Tüm Gmail taslak iletilerini alır.
getInboxThreads()GmailThread[]Etiketlere bakılmaksızın tüm gelen kutusu ileti dizilerini alır.
getInboxThreads(start, max)GmailThread[]Etiketlere bakılmaksızın bir dizi gelen kutusu ileti dizisini alır.
getInboxUnreadCount()IntegerGelen kutusundaki okunmamış ileti dizilerinin sayısını alır.
getMessageById(id)GmailMessageKimliğe göre bir 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[]Etiketlere bakılmaksızın tüm Öncelikli E-postalar ileti dizilerini alır.
getPriorityInboxThreads(start, max)GmailThread[]Etiketlere bakılmaksızın bir dizi Öncelikli E-postalar ileti dizisini alır.
getPriorityInboxUnreadCount()IntegerÖncelikli Gelen Kutusu'ndaki okunmamış ileti dizilerinin sayısını alır.
getSpamThreads()GmailThread[]Etiketlere bakılmaksızın tüm spam ileti dizilerini alır.
getSpamThreads(start, max)GmailThread[]Etiketlerden bağımsız olarak bir dizi spam ileti dizisini alır.
getSpamUnreadCount()IntegerSpam olan okunmamış ileti dizilerinin sayısını alır.
getStarredThreads()GmailThread[]Etiketlere bakılmaksızın yıldız işaretli tüm ileti dizilerini alır.
getStarredThreads(start, max)GmailThread[]Etiketlere bakılmaksızın yıldızlı ileti dizilerinin bir aralığını alır.
getStarredUnreadCount()IntegerYıldız işareti verilen okunmamış ileti dizilerinin sayısını alır.
getThreadById(id)GmailThreadKimliğe göre ileti dizisi alır.
getTrashThreads()GmailThread[]Etiketlere bakılmaksızın tüm çöp ileti dizilerini alır.
getTrashThreads(start, max)GmailThread[]Etiketlere bakılmaksızın bir dizi çöp ileti dizisi alır.
getUserLabelByName(name)GmailLabelEtiket adı verilen bir etiketi alır.
getUserLabels()GmailLabel[]Kullanıcı tarafından oluşturulan etiketlerin listesini alır.
markMessageRead(message)GmailAppBu mesajı okundu olarak işaretler ve mesajın yenilenmesini zorlar.
markMessageUnread(message)GmailAppBu mesajı okunmamış olarak işaretler ve mesajın yenilenmesini zorlar.
markMessagesRead(messages)GmailAppBu iletileri okundu olarak işaretler ve iletileri yenilemeye zorlar.
markMessagesUnread(messages)GmailAppBu iletileri okunmamış olarak işaretler ve iletileri yenilemeye zorlar.
markThreadImportant(thread)GmailAppBu ileti dizisini önemli olarak işaretler ve ileti dizisinin yenilenmesini zorlar.
markThreadRead(thread)GmailAppBu ileti dizisini okundu olarak işaretler ve ileti dizisini yenilemeye zorlar.
markThreadUnimportant(thread)GmailAppBu ileti dizisini önemsiz olarak işaretler ve ileti dizisinin yenilenmesini zorlar.
markThreadUnread(thread)GmailAppBu ileti dizisini okunmamış olarak işaretler ve ileti dizisini yenilemeye zorlar.
markThreadsImportant(threads)GmailAppBu ileti dizilerini önemli olarak işaretler ve yenilenmesini zorlar.
markThreadsRead(threads)GmailAppBu ileti dizilerini okundu olarak işaretler ve yenilenmesini zorlar.
markThreadsUnimportant(threads)GmailAppBu ileti dizilerini önemsiz olarak işaretler ve yenilenmesini zorlar.
markThreadsUnread(threads)GmailAppBu ileti dizilerini okunmadı olarak işaretler ve yenilenmesini zorlar.
moveMessageToTrash(message)GmailAppİleti çöp kutusuna taşınır ve iletiyi yenilemeye zorlar.
moveMessagesToTrash(messages)GmailAppBelirtilen iletileri çöp kutusuna taşır ve iletilerin yenilenmesini zorlar.
moveThreadToArchive(thread)GmailAppBu ileti dizisini arşive taşır ve ileti dizisinin yenilenmesini zorlar.
moveThreadToInbox(thread)GmailAppBu ileti dizisini gelen kutusuna taşır ve ileti dizisinin yenilenmesini zorlar.
moveThreadToSpam(thread)GmailAppBu ileti dizisini spam'e taşır ve ileti dizisinin yenilenmesini zorlar.
moveThreadToTrash(thread)GmailAppBu ileti dizisini çöp kutusuna taşır ve ileti dizisinin yenilenmesini zorlar.
moveThreadsToArchive(threads)GmailAppBu ileti dizilerini arşive taşır ve ileti dizilerinin yenilenmesini zorlar.
moveThreadsToInbox(threads)GmailAppBu ileti dizilerini gelen kutusuna taşır ve ileti dizilerinin yenilenmesini zorlar.
moveThreadsToSpam(threads)GmailAppBu ileti dizilerini spam'e taşır ve ileti dizilerinin yenilenmesini zorlar.
moveThreadsToTrash(threads)GmailAppBu ileti dizilerini çöp kutusuna taşır ve ileti dizilerinin yenilenmesini zorlar.
refreshMessage(message)GmailAppİletiyi ve ilişkili durumu Gmail'den yeniden yükler (etiketler, okunma durumu vb. değiştiyse kullanışlıdır).
refreshMessages(messages)GmailAppGmail'deki iletileri ve ilişkili durumu yeniden yükler (etiketler, okunma durumu vb. değiştiyse kullanışlıdır).
refreshThread(thread)GmailAppGmail'den ileti dizisini ve ilişkili durumu yeniden yükler (etiketler, okunma durumu vb. değiştiyse kullanışlıdır).
refreshThreads(threads)GmailAppGmail'deki ileti dizilerini ve ilişkili durumu yeniden yükler (etiketler, okunma durumu vb. değiştiyse kullanışlıdır).
search(query)GmailThread[]Belirtilen sorguyla Gmail'de arama yapın.
search(query, start, max)GmailThread[]Belirtilen sorguyla Gmail'de 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 mesajı gönderir.
setCurrentMessageAccessToken(accessToken)voidKomut dosyasının mevcut GmailMessage özelliklerine erişmesini sağlayan mevcut mesaj erişim jetonunu ayarlar.
starMessage(message)GmailAppBu iletiye yıldız ekler ve iletiyi yenilemeye zorlar.
starMessages(messages)GmailAppBu iletilere yıldız ekler ve iletilerin yenilenmesini zorlar.
unstarMessage(message)GmailAppBu iletiden yıldızı kaldırır ve iletiyi yenilemeye zorlar.
unstarMessages(messages)GmailAppBu iletilerdeki yıldızları kaldırır ve iletilerin yenilenmesini zorlar.

Ayrıntılı dokümanlar

createDraft(recipient, subject, body)

E-posta mesajı taslağı oluşturur. E-postanın boyutu (üstbilgiler dahil) kota sınırına ulaştı.

// The code below creates a draft email with the current date and time.
const 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 Gmail taslağı

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:


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 HTML gövde içerebilir. E-postanın boyutu (üstbilgiler dahil ancak ekler hariç) kota sınırına ulaşmıştır.

// Create a draft email with a file from Google Drive attached as a PDF.
const 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 mesajı
optionsObjectAşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[]E-postayla gönderilecek bir dosya dizisi
bccStringGizli alıcının e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC alanına eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringE-postanın gönderileceği adres. Bu adres, getAliases() tarafından döndürülen değerlerden biri olmalıdır.
htmlBodyStringAyarlanırsa HTML oluşturabilen cihazlar, zorunlu body bağımsız değişkeni yerine bunu kullanır. E-postanız için satır içi resimler eklediyseniz HTML gövdesine isteğe bağlı bir inlineImages alanı ekleyebilirsiniz
inlineImagesObjectResim anahtarından (String) resim verilerine (BlobSource) bir eşleme içeren bir JavaScript nesnesi; bu durumda htmlBody parametresinin kullanıldığı ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiği varsayılır
nameStringE-postayı gönderen kişinin adı (varsayılan: kullanıcının adı)
replyToStringVarsayılan yanıtlama adresi olarak kullanılacak e-posta adresi (varsayılan: kullanıcının e-posta adresi)

Return

GmailDraft: Yeni oluşturulan Gmail taslağı

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:


createLabel(name)

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

Belirtilen etiketi siler.

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

Parametreler

AdTürAçıklama
labelGmailLabelsilinecek etiket

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


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 adlardan herhangi birinden mesaj gönderebilirsiniz.

// Log the aliases for this Gmail account and send an email as the first one.
const me = Session.getActiveUser().getEmail();
const 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 hesap için bir takma ad 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/

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


getDraft(draftId)

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

Bu işlevi Gmail taslaklarında getId() ile birlikte kullanın.

// Get the first draft message in your drafts folder
const draft = GmailApp.getDrafts()[0];
// Get its ID
const draftId = draft.getId();
// Now fetch the same draft using that ID.
const 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: Belirtilen kimliğe sahip taslak

Atışlar

Error: Belirtilen kimliğe sahip taslak bulunamazsa

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/

getDraftMessages()

Tüm taslak iletileri alır.

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

Return

GmailMessage[]: taslak Gmail iletilerinin 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/

getDrafts()

Tüm Gmail taslak iletilerini alır.

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

Return

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

getInboxThreads()

Etiketlere bakılmaksızın tüm gelen kutusu ileti dizilerini alır.

Tüm mesaj dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrı başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen "sayfalanmış" çağrıyı kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

// Log the subject lines of your Inbox
const threads = GmailApp.getInboxThreads();
for (let 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getInboxThreads(start, max)

Etiketlere bakılmaksızın bir dizi gelen kutusu ileti dizisini alır.

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

Parametreler

AdTürAçıklama
startIntegerAlınacak ilk ileti dizisinin dizini
maxIntegerAlınacak maksimum mesaj dizisi sayısı

Return

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

getInboxUnreadCount()

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

Logger.log(`Messages unread in inbox: ${GmailApp.getInboxUnreadCount()}`);

Return

Integer: Gelen kutusunda okunmamış mesaj bulunan 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/

getMessageById(id)

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

Bu işlevi Gmail iletilerinde getId() ile birlikte kullanın.

// Get the first message in the first thread of your inbox
const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
const messageId = message.getId();
// Now fetch the same message using that ID.
const 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
idStringAlınacak mesajın kimliği

Return

GmailMessage: Belirtilen kimliğe sahip ileti

Atışlar

Error: Belirtilen kimliğe sahip ileti bulunamazsa

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:


getMessagesForThread(thread)

Belirtilen ileti dizisindeki tüm iletileri alın.

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

Parametreler

AdTürAçıklama
threadGmailThreadAlınacak ileti dizisi

Return

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

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
const thread = GmailApp.getInboxThreads(0, 2);
const messages = GmailApp.getMessagesForThreads(thread);
for (let i = 0; i < messages.length; i++) {
  for (let j = 0; j < messages[i].length; j++) {
    Logger.log(`subject: ${messages[i][j].getSubject()}`);
  }
}

Parametreler

AdTürAçıklama
threadsGmailThread[]Alınacak mesaj dizileri

Return

GmailMessage[][]: Dış dizindeki her öğenin bir ileti dizisine karşılık geldiği ve iç dizinin bu ileti dizisindeki iletileri içerdiği bir ileti dizisi 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/

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


getPriorityInboxThreads()

Etiketlere bakılmaksızın tüm Öncelikli E-postalar ileti dizilerini alır.

Tüm mesaj dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrı başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen "sayfalanmış" çağrıyı 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 Gmail ileti 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/

getPriorityInboxThreads(start, max)

Etiketlere bakılmaksızın bir dizi Öncelikli E-postalar ileti dizisini 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
startIntegerAlınacak ilk ileti dizisinin dizini
maxIntegerAlınacak maksimum mesaj dizisi sayısı

Return

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

getPriorityInboxUnreadCount()

Öncelikli Gelen Kutusu'ndaki okunmamış ileti dizilerinin sayısını alır.

Logger.log(
    `Number of unread emails in your Priority Inbox : ${
        GmailApp.getPriorityInboxUnreadCount()}`,
);

Return

Integer: Öncelikli Gelen Kutusu'nda okunmamış mesaj içeren 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/

getSpamThreads()

Etiketlere bakılmaksızın tüm spam ileti dizilerini alır.

Tüm mesaj dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrı başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen "sayfalanmış" çağrıyı 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 ileti 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/

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
startIntegerAlınacak ilk ileti dizisinin dizini
maxIntegerAlınacak maksimum mesaj dizisi sayısı

Return

GmailThread[]: Spam klasöründeki Gmail ileti 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/

getSpamUnreadCount()

Spam olan okunmamış 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ış mesaj içeren spam 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/

getStarredThreads()

Etiketlere bakılmaksızın yıldız işaretli tüm ileti dizilerini alır.

Tüm mesaj dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrı başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen "sayfalanmış" çağrıyı 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getStarredThreads(start, max)

Etiketlere bakılmaksızın yıldızlı ileti dizilerinin bir aralığını 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
startIntegerAlınacak ilk ileti dizisinin dizini
maxIntegerAlınacak maksimum mesaj dizisi sayısı

Return

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

getStarredUnreadCount()

Yıldız işareti verilen okunmamış ileti dizilerinin sayısını alır.

Logger.log(`# unread and starred: ${GmailApp.getStarredUnreadCount()}`);

Return

Integer: Okunmamış mesaj içeren yıldızlı 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/

getThreadById(id)

Kimliğe göre ileti dizisi alır.

Bu işlevi 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 ileti dizisinin kimliği.

Return

GmailThread: Belirtilen kimliğe sahip ileti dizisi veya bulunamazsa null.

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:


getTrashThreads()

Etiketlere bakılmaksızın tüm çöp ileti dizilerini alır.

Tüm mesaj dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrı başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen "sayfalanmış" çağrıyı 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getTrashThreads(start, max)

Etiketlere bakılmaksızın bir dizi çöp ileti dizisi alır.

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

Parametreler

AdTürAçıklama
startIntegerAlınacak ilk ileti dizisinin dizini
maxIntegerAlınacak maksimum mesaj dizisi sayısı

Return

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

getUserLabelByName(name)

Etiket adı verilen bir etiketi alır.

const labelObject = GmailApp.getUserLabelByName('myLabel');

Parametreler

AdTürAçıklama
nameStringAlınacak etiketin adı

Return

GmailLabel: Belirtilen ada sahip Gmail etiketi

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/

getUserLabels()

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

// Logs all of the names of your labels
const labels = GmailApp.getUserLabels();
for (let 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

markMessageRead(message)

Bu mesajı okundu olarak işaretler ve mesajın yenilenmesini zorlar.

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

Parametreler

AdTürAçıklama
messageGmailMessageOkundu olarak işaretlenecek ileti

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markMessageUnread(message)

Bu mesajı okunmamış olarak işaretler ve mesajın yenilenmesini zorlar.

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

Parametreler

AdTürAçıklama
messageGmailMessageOkunmadı olarak işaretlenecek ileti

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markMessagesRead(messages)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markMessagesUnread(messages)

Bu iletileri okunmamış olarak işaretler ve iletileri yenilemeye zorlar.

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadImportant(thread)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadRead(thread)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadUnimportant(thread)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadUnread(thread)

Bu ileti dizisini okunmamış olarak işaretler ve ileti dizisini yenilemeye zorlar.

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadsImportant(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadsRead(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadsUnimportant(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


markThreadsUnread(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveMessageToTrash(message)

İleti çöp kutusuna taşınır ve iletiyi yenilemeye zorlar.

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

Parametreler

AdTürAçıklama
messageGmailMessageÇöp kutusuna gönderilecek ileti

Return

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

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:


moveMessagesToTrash(messages)

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

// Move first two messages in your inbox to trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
const 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 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:


moveThreadToArchive(thread)

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

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

Parametreler

AdTürAçıklama
threadGmailThreadArşivlenecek mesaj dizisi

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadToInbox(thread)

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

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

Parametreler

AdTürAçıklama
threadGmailThreadGelen kutusuna taşınacak ileti dizisi

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadToSpam(thread)

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

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

Parametreler

AdTürAçıklama
threadGmailThreadspam klasörüne taşınacak ileti dizisi

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadToTrash(thread)

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

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

Parametreler

AdTürAçıklama
threadGmailThreadÇöp kutusuna gönderilecek ileti dizisi

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadsToArchive(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadsToInbox(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadsToSpam(threads)

Bu ileti dizilerini spam'e taşır ve ileti dizilerinin yenilenmesini zorlar.

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


moveThreadsToTrash(threads)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


refreshMessage(message)

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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: Zincirleme için kullanışlı olan Gmail hizmeti

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:


refreshMessages(messages)

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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: Zincirleme için kullanışlı olan Gmail hizmeti

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:


refreshThread(thread)

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

const 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: Zincirleme için kullanışlı olan Gmail hizmeti

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:


refreshThreads(threads)

Gmail'deki ileti dizilerini ve ilişkili durumu yeniden yükler (etiketler, okunma durumu vb. değiştiyse kullanışlıdır).

const 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: Zincirleme için kullanışlı olan Gmail hizmeti

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:


search(query)

Belirtilen sorguyla Gmail'de arama yapın.

Tüm mesaj dizilerinin boyutu sistemin işleyemeyeceği kadar büyük olduğunda bu çağrı başarısız olur. İleti dizisi boyutu bilinmiyorsa ve büyük olasılıkla çok büyükse lütfen "sayfalanmış" çağrıyı kullanın ve her çağrıda alınacak ileti dizisi aralıklarını belirtin.

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

Parametreler

AdTürAçıklama
queryStringGmail'e yazarken kullanacağınız arama sorgusu

Return

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

search(query, start, max)

Belirtilen sorguyla Gmail'de 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.
const threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Parametreler

AdTürAçıklama
queryStringGmail'e yazarken kullanacağınız arama sorgusu
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 ileti 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/

sendEmail(recipient, subject, body)

E-posta mesajı gönderir. E-postanın boyutu (üstbilgiler dahil) kota sınırına ulaştı.

// The code below will send an email with the current date and time.
const 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: Zincirleme için kullanışlı olan Gmail hizmeti

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:


sendEmail(recipient, subject, body, options)

İsteğe bağlı bağımsız değişkenler içeren bir e-posta mesajı 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ırına ulaşmıştır.

// Send an email with a file from Google Drive attached as a PDF.
const 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 mesajı
optionsObjectAşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[]E-postayla gönderilecek bir dosya dizisi
bccStringGizli alıcının e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC alanına eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringE-postanın gönderileceği adres. Bu adres, getAliases() tarafından döndürülen değerlerden biri olmalıdır.
htmlBodyStringAyarlanırsa HTML oluşturabilen cihazlar, zorunlu body bağımsız değişkeni yerine bunu kullanır. E-postanız için satır içi resimler eklediyseniz HTML gövdesine isteğe bağlı bir inlineImages alanı ekleyebilirsiniz
inlineImagesObjectResim anahtarından (String) resim verilerine (BlobSource) bir eşleme içeren bir JavaScript nesnesi; bu durumda htmlBody parametresinin kullanıldığı ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiği varsayılır
nameStringE-postayı gönderen kişinin adı (varsayılan: kullanıcının adı)
noReplyBooleantrue, e-postanın alıcıları e-postalara yanıt vermekten vazgeçirmek için genel bir yanıtsız e-posta adresinden gönderilmesi gerekiyorsa; bu seçenek yalnızca Google Workspace hesapları için kullanılabilir, Gmail kullanıcıları tarafından kullanılamaz
replyToStringVarsayılan yanıtlama adresi olarak kullanılacak e-posta adresi (varsayılan: kullanıcının e-posta adresi)

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


setCurrentMessageAccessToken(accessToken)

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

Yalnızca Gmail mesaj kapsamlarını kullanan Google Workspace eklentisi projeleri bu yöntemi gerektirir.

function handleAddonActionEvent(e) {
  GmailApp.setCurrentMessageAccessToken(e.messageMetadata.accessToken);
  const mailMessage = GmailApp.getMessageById(e.messageMetadata.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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

starMessage(message)

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

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


starMessages(messages)

Bu iletilere yıldız ekler ve iletilerin yenilenmesini zorlar.

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

Parametreler

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

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


unstarMessage(message)

Bu iletiden yıldızı kaldırır ve iletiyi yenilemeye zorlar.

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

Parametreler

AdTürAçıklama
messageGmailMessageYıldızının kaldırılmasını istediğiniz mesaj

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:


unstarMessages(messages)

Bu iletilerdeki yıldızları kaldırır ve iletilerin yenilenmesini zorlar.

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

Parametreler

AdTürAçıklama
messagesGmailMessage[]Yıldız işareti kaldırılacak ileti dizisi

Return

GmailApp: Zincirleme için kullanışlı olan Gmail hizmeti

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:

Kullanımdan kaldırılan yöntemler