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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
get | Integer | Günün geri kalanında e-posta gönderebileceğiniz alıcı sayısını döndürür. |
send | void | E-posta mesajı gönderir. |
send | void | E-posta mesajı gönderir. |
send | void | İsteğe bağlı bağımsız değişkenler içeren bir e-posta mesajı gönderir. |
send | void | E-posta mesajı gönderir. |
Ayrıntılı dokümanlar
get Remaining Daily Quota()
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
send Email(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
Ad | Tür | Açıklama |
---|---|---|
message | Object | E-posta mesajını temsil eden bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
attachments | Blob | E-postayla gönderilecek bir dosya dizisi |
bcc | String | Gizli alıcının e-posta adreslerinin virgülle ayrılmış listesi |
body | String | e-postanın mesajı |
cc | String | CC alanına eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
html | String | Ayarlanı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 inline alanı ekleyebilirsiniz |
inline | Object | Resim anahtarından (String ) resim verilerine (Blob ) bir eşleme içeren bir JavaScript nesnesi; bu durumda html 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) |
name | String | E-postayı gönderen kişinin adı. Varsayılan olarak gönderenin kullanıcı adıdır. |
no | Boolean | true , 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 |
reply | String | Varsayılan yanıtlama adresi olarak kullanılacak bir e-posta adresi (varsayılan: kullanıcının e-posta adresi). no true olarak ayarlanırsa reply 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ı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:
send Email(recipient, subject, body)
E-posta mesajı gönderir.
App.sendEmail( 'recipient@example.com', 'TPS reports', 'Where are the TPS reports?', );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
recipient | String | Alıcıların adresleri, virgülle ayrılmış |
subject | String | konu satırı |
body | String | e-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
send Email(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
Ad | Tür | Açıklama |
---|---|---|
recipient | String | Alıcıların adresleri, virgülle ayrılmış |
subject | String | konu satırı |
body | String | e-postanın mesajı |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
attachments | Blob | E-postayla gönderilecek bir dosya dizisi (örneğe bakın) |
bcc | String | Gizli alıcının e-posta adreslerinin virgülle ayrılmış listesi |
cc | String | CC alanına eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
html | String | Ayarlanı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 inline alanı ekleyebilirsiniz |
inline | Object | Resim anahtarından (String ) resim verilerine (Blob ) bir eşleme içeren bir JavaScript nesnesi; bu durumda html parametresinin kullanıldığı ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiği varsayılır |
name | String | E-postayı gönderen kişinin adı (varsayılan: kullanıcının adı) |
no | Boolean | true , 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 |
reply | String | Varsayı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:
send Email(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.
App.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 adresleri, virgülle ayrılmış |
reply | String | yanıt adresi |
subject | String | konu satırı |
body | String | E-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