Class MailApp

MailApp

E-posta gönderir.

Bu hizmet, kullanıcıların e-posta içeriği üzerinde tam denetime sahip olarak e-posta göndermesine olanak tanır. GmailApp'in aksine MailApp'in tek amacı e-posta göndermektir. MailApp kullanıcının Gmail gelen kutusuna erişemez.

GmailApp kullanılarak yazılan komut dosyalarında yapılan değişikliklerin, MailApp komut dosyalarından ziyade bir kullanıcıdan yeniden yetkilendirme isteğini tetikleme olasılığı daha yüksektir.

Yöntemler

YöntemDönüş türüKısa açıklama
getRemainingDailyQuota()IntegerGünün geri kalanında e-posta gönderebileceğiniz alıcı sayısını döndürür.
sendEmail(message)voidE-posta mesajı gönderir.
sendEmail(recipient, subject, body)voidE-posta mesajı gönderir.
sendEmail(recipient, subject, body, options)voidİsteğe bağlı bağımsız değişkenler içeren bir e-posta iletisi gönderir.
sendEmail(to, replyTo, subject, body)voidE-posta mesajı gönderir.

Ayrıntılı belgeler

getRemainingDailyQuota()

Günün geri kalanında e-posta gönderebileceğiniz alıcı sayısını döndürür. Döndürülen değer, mevcut yürütme için geçerlidir ve yürütme işlemleri arasında değişiklik gösterebilir.

Kotalar, e-posta alıcılarının sayısına göre belirlenir. Belirli kota bilgileri için Google Hizmetleri Kotalar sayfasına bakın.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

Return

Integer: Komut dosyasının gönderebileceği kalan e-posta sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/script.send_mail

sendEmail(message)

E-posta mesajı gönderir. Yöntemin bu varyasyonu çok daha esnektir ve çok daha fazla seçeneğe olanak tanır.

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png";
  var youtubeLogoUrl =
        "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png";
  var googleLogoBlob = UrlFetchApp
                         .fetch(googleLogoUrl)
                         .getBlob()
                         .setName("googleLogoBlob");
  var youtubeLogoBlob = UrlFetchApp
                          .fetch(youtubeLogoUrl)
                          .getBlob()
                          .setName("youtubeLogoBlob");
  MailApp.sendEmail({
    to: "recipient@example.com",
    subject: "Logos",
    htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" +
              "inline YouTube Logo <img src='cid:youtubeLogo'>",
    inlineImages:
      {
        googleLogo: googleLogoBlob,
        youtubeLogo: youtubeLogoBlob
      }
  });
}

Parametreler

AdTürAçıklama
messageObjectBir e-posta mesajını temsil eden 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
bodyStringe-postanın gövdesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
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 (örneğe bakın)
nameStringe-postayı gönderenin adı. Varsayılan olarak gönderenin kullanıcı adıdır.
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). noReply, true olarak ayarlanırsa replyTo yoksayılır.
subjectStringe-postanın konusu
toStringalıcının e-posta adresi veya alıcılar olacak e-posta adreslerinin virgülle ayrılmış listesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/script.send_mail

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


sendEmail(recipient, subject, body)

E-posta mesajı gönderir.

MailApp.sendEmail("recipient@example.com",
                  "TPS reports",
                  "Where are the TPS reports?");

Parametreler

AdTürAçıklama
recipientStringalıcıların, virgülle ayrılmış adresleri
subjectStringkonu satırı
bodyStringe-postanın gövdesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/script.send_mail

sendEmail(recipient, subject, body, options)

İsteğe bağlı bağımsız değişkenler içeren bir e-posta iletisi gönderir.

// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html');
MailApp.sendEmail('mike@example.com', 'Attachment example', 'Two files are attached.', {
    name: 'Automatic Emailer Script',
    attachments: [file.getAs(MimeType.PDF), blob]
});

Parametreler

AdTürAçıklama
recipientStringalıcıların, virgülle ayrılmış 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 dosya dizisi (örneği inceleyin)
bccStringBCC'ye e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
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)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/script.send_mail

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


sendEmail(to, replyTo, subject, body)

E-posta mesajı gönderir. Bu yöntem, kullanıcının, gönderilen ileti için gönderenden farklı olabilecek bir Yanıt adresini kolayca belirtmesine olanak tanır.

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "TPS report status",
                  "What is the status of those TPS reports?");

Parametreler

AdTürAçıklama
toStringalıcıların, virgülle ayrılmış adresleri
replyToStringyanıt adresi
subjectStringkonu satırı
bodyStringe-postanın düz metin olarak gövdesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/script.send_mail