Class MailApp

MailApp

E-posta gönderir.

Bu hizmet, kullanıcıların e-postanın içeriği üzerinde tam denetime sahip olarak e-posta göndermesine olanak sağlar. GmailApp'in aksine MailApp'in tek amacı e-posta göndermektir. MailApp bir kullanıcının Gmail'ine erişemiyor gelen kutusu.

GmailApp kullanılarak yazılan komut dosyalarında yapılan değişikliklerin yeniden yetkilendirme tetikleme olasılığı daha yüksektir isteği MailApp komut dosyalarından farklıdır.

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)voidBir e-posta iletisi gönderir.
sendEmail(recipient, subject, body)voidBir e-posta iletisi 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)voidBir e-posta iletisi 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ğeri mevcut yürütme için geçerlidir ve yürütmeler arasında değişiklik gösterebilir.

Kotalar, e-posta alıcısı sayısına göre belirlenir. Özel kota bilgileri için bkz. Google için Kotalar Hizmetler.

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

sendEmail(message)

Bir e-posta iletisi gönderir. Yöntemin bu varyasyonu çok daha esnektir ve birçok daha fazla seçenek.

// 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 dosya dizisi
bccStringBCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
bodyStringe-postanın gövdesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
htmlBodyStringayarlanmışsa HTML oluşturabilen cihazlar bunun yerine bunu kullanır gerekir. HTML'ye isteğe bağlı bir inlineImages alanı ekleyebilirsiniz E-postanız için satır içi resimler varsa gövde metni
inlineImagesObjectresim anahtarından eşleme içeren bir JavaScript nesnesi (String) görüntü verilerine (BlobSource) göre; bu, htmlBody parametresinin kullanıldığını ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiğini varsayar (örneğe bakın)
nameStringe-postayı gönderen kişinin adı. Varsayılan olarak gönderenin kullanıcı adı.
noReplyBooleanE-postanın genel bir adresten gönderilmesi gerekiyorsa true Alıcıları e-postaları yanıtlamaktan caydırmak için yanıt kabul etmeyen e-posta adresi; 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 e-posta adresinin alıcı olacak e-posta adresleri

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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)

Bir e-posta iletisi gönderir.

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

Parametreler

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 adresleri (virgülle ayrılmış olarak)
subjectStringkonu satırı
bodyStringe-postanın gövdesi
optionsObjectaşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[] e-postayla gönderilecek dosya dizisi (örneğe bakın)
bccStringBCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
htmlBodyStringayarlanmışsa HTML oluşturabilen cihazlar bunun yerine bunu kullanır gerekir. HTML'ye isteğe bağlı bir inlineImages alanı ekleyebilirsiniz E-postanız için satır içi resimler varsa gövde metni
inlineImagesObjectresim anahtarından eşleme içeren bir JavaScript nesnesi (String) görüntü verilerine (BlobSource) göre; htmlBody parametresinin kullanıldığı ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiği varsayılır
nameStringe-postayı gönderenin adı (varsayılan: kullanıcının adı)
noReplyBooleanE-postanın genel bir adresten gönderilmesi gerekiyorsa true Alıcıları e-postaları yanıtlamaktan caydırmak için yanıt kabul etmeyen e-posta adresi; 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 kapsamlardan bir 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)

Bir e-posta iletisi gönderir. Bu yöntem, kullanıcının gönderenden farklı olabilecek bir ileti gönderilir.

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 adresleri (virgülle ayrılmış olarak)
replyToStringyanıt adresi
subjectStringkonu satırı
bodyStringe-posta gövdesinin düz metin

Yetkilendirme

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

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