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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
getRemainingDailyQuota() | Integer | Günün geri kalanında e-posta gönderebileceğiniz alıcı sayısını döndürür. |
sendEmail(message) | void | E-posta mesajı gönderir. |
sendEmail(recipient, subject, body) | void | E-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) | void | E-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
Ad | Tür | Açıklama |
---|---|---|
message | Object | Bir e-posta mesajını temsil eden JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
attachments | BlobSource[] | e-postayla gönderilecek bir dosya dizisi |
bcc | String | BCC'ye e-posta adreslerinin virgülle ayrılmış listesi |
body | String | e-postanın gövdesi |
cc | String | CC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
htmlBody | String | ayarlanı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 |
inlineImages | Object | resim 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) |
name | String | e-postayı gönderenin adı. Varsayılan olarak gönderenin kullanıcı adıdır. |
noReply | Boolean | E-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 |
replyTo | String | varsayı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. |
subject | String | e-postanın konusu |
to | String | alı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
Ad | Tür | Açıklama |
---|---|---|
recipient | String | alıcıların, virgülle ayrılmış adresleri |
subject | String | konu satırı |
body | String | e-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
Ad | Tür | Açıklama |
---|---|---|
recipient | String | alıcıların, virgülle ayrılmış adresleri |
subject | String | konu satırı |
body | String | e-postanın gövdesi |
options | Object | aşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
attachments | BlobSource[] | e-postayla gönderilecek dosya dizisi (örneği inceleyin) |
bcc | String | BCC'ye e-posta adreslerinin virgülle ayrılmış listesi |
cc | String | CC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
htmlBody | String | ayarlanı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 |
inlineImages | Object | resim 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. |
name | String | e-postayı gönderenin adı (varsayılan: kullanıcının adı) |
noReply | Boolean | E-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 |
replyTo | String | varsayı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
Ad | Tür | Açıklama |
---|---|---|
to | String | alıcıların, virgülle ayrılmış adresleri |
replyTo | String | yanıt adresi |
subject | String | konu satırı |
body | String | e-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