Class MailApp

PostaUygulama

E-posta gönderir.

Bu hizmet, kullanıcıların e-posta içeriği üzerinde tam kontrol sahibi 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şiklikler, MailApp komut dosyalarına kıyasla kullanıcıdan yeniden yetkilendirme isteği 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 mesajı gönderir.
sendEmail(to, replyTo, subject, body)voidE-posta mesajı gönderir.

Ayrıntılı dokümanlar

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 geçerli yürütme için geçerlidir ve yürütmeler arasında değişiklik gösterebilir.

Kotalar, e-posta alıcılarının sayısına göre belirlenir. Kotalarla ilgili ayrıntılı bilgi için Google Hizmetleri için kotalar başlıklı makaleyi inceleyin.

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

sendEmail(message)

E-posta mesajı gönderir. Yöntemin bu varyasyonu çok daha esnektir ve daha fazla seçenek sunar.

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  const googleLogoUrl =
      'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png';
  const youtubeLogoUrl =
      'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png';
  const googleLogoBlob =
      UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob');
  const 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
messageObjectE-posta mesajını temsil eden 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
bodyStringe-postanın mesajı
ccStringCC alanına eklenecek e-posta adreslerinin virgülle ayrılmış listesi
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 (örnek bölümüne bakın)
nameStringE-postayı gönderen kişinin adı. Varsayılan olarak gönderenin kullanıcı adıdır.
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 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 adresleri, virgülle ayrılmış
subjectStringkonu satırı
bodyStringe-postanın mesajı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 mesajı gönderir.

// Send an email with two attachments: a file from Google Drive (as a PDF) and
// an HTML file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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ış
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 (örneğe bakın)
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
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)

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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önderdiği ileti için kolayca bir Yanıtla adresi belirtmesine olanak tanır. Bu adres, gönderenden farklı olabilir.

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ış
replyToStringyanıt adresi
subjectStringkonu satırı
bodyStringE-postanın düz metin olarak gövde kısmı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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