Class MailApp

MailApp

ईमेल भेजता है.

इस सेवा की मदद से उपयोगकर्ता, ईमेल के कॉन्टेंट को पूरी तरह से कंट्रोल करके ईमेल भेज सकते हैं. GmailApp से अलग, MailApp का मकसद सिर्फ़ ईमेल भेजना है. MailApp उपयोगकर्ता के Gmail इनबॉक्स को ऐक्सेस नहीं कर सकता.

इस बात की संभावना ज़्यादा है कि GmailApp का इस्तेमाल करके लिखी गई स्क्रिप्ट में किए गए बदलावों से, MailApp स्क्रिप्ट के बजाय, उपयोगकर्ता के पास फिर से अनुमति लेने का अनुरोध ट्रिगर हो.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getRemainingDailyQuota()Integerदिन के बाकी बचे समय में, उन लोगों की संख्या दिखाता है जिन्हें ईमेल भेजा जा सकता है.
sendEmail(message)voidईमेल मैसेज भेजता है.
sendEmail(recipient, subject, body)voidईमेल मैसेज भेजता है.
sendEmail(recipient, subject, body, options)voidवैकल्पिक तर्कों के साथ ईमेल मैसेज भेजता है.
sendEmail(to, replyTo, subject, body)voidईमेल मैसेज भेजता है.

ज़्यादा जानकारी के साथ दस्तावेज़

getRemainingDailyQuota()

दिन के बाकी बचे समय में, उन लोगों की संख्या दिखाता है जिन्हें ईमेल भेजा जा सकता है. मिलने वाली वैल्यू, मौजूदा एक्ज़ीक्यूशन के लिए मान्य है और एक्ज़ीक्यूशन के हिसाब से अलग-अलग हो सकती है.

कोटा, ईमेल पाने वालों की संख्या के आधार पर तय किए जाते हैं. कोटा के बारे में खास जानकारी के लिए, Google Services के लिए कोटा देखें.

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

रिटर्न

Integer — बाकी बचे ईमेल की संख्या, जिन्हें स्क्रिप्ट भेज सकती है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

sendEmail(message)

ईमेल मैसेज भेजता है. इस तरीके का यह वैरिएशन ज़्यादा सुविधाजनक है और इससे आपको कई और विकल्प मिलते हैं.

// 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
      }
  });
}

पैरामीटर

नामTypeब्यौरा
messageObjectJavaScript ऑब्जेक्ट, जो ईमेल मैसेज को दिखाता है

उन्नत पैरामीटर

नामTypeब्यौरा
attachmentsBlobSource[]ईमेल के साथ भेजने के लिए फ़ाइलों का कलेक्शन
bccStringगुप्त कॉपी फ़ील्ड में ईमेल पतों की कॉमा-सेपरेटेड लिस्ट
bodyStringईमेल का मुख्य हिस्सा
ccStringकॉपी में ईमेल पतों की कॉमा-सेपरेटेड लिस्ट
htmlBodyStringअगर सेट किया जाता है, तो एचटीएमएल रेंडर करने की सुविधा वाले डिवाइस, ज़रूरी तर्क के बजाय इसका इस्तेमाल करेंगे. अगर आपके पास अपने ईमेल के लिए इनलाइन इमेज हैं, तो एचटीएमएल बॉडी में एक वैकल्पिक inlineImages फ़ील्ड भी जोड़ा जा सकता है
inlineImagesObjectयह एक JavaScript ऑब्जेक्ट है, जिसमें इमेज कुंजी (String) से इमेज डेटा (BlobSource) को मैप किया जाता है; इसमें यह माना जाता है कि htmlBody पैरामीटर का इस्तेमाल किया जाता है और इसमें <img src="cid:imageKey" /> फ़ॉर्मैट में इन इमेज का रेफ़रंस शामिल है (उदाहरण देखें)
nameStringईमेल भेजने वाले का नाम. डिफ़ॉल्ट तौर पर, ईमेल भेजने वाले का उपयोगकर्ता नाम सेट होता है.
noReplyBooleantrue, अगर ईमेल पाने वाले लोगों को ईमेल का जवाब देने से रोकने के लिए, ऐसे सामान्य ईमेल पते से भेजा गया हो जिसका जवाब नहीं दिया जा सकता. इस विकल्प का इस्तेमाल सिर्फ़ Google Workspace खातों के लिए किया जा सकता है, Gmail का इस्तेमाल करने वाले लोगों के लिए नहीं
replyToStringजवाब देने के डिफ़ॉल्ट पते के तौर पर इस्तेमाल करने के लिए, एक ईमेल पता (डिफ़ॉल्ट: उपयोगकर्ता का ईमेल पता). अगर noReply को true पर सेट किया जाता है, तो replyTo को अनदेखा कर दिया जाता है.
subjectStringईमेल का विषय
toStringपाने वाले का ईमेल पता या पाने वालों के ईमेल पतों की कॉमा-सेपरेटेड लिस्ट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

इन्हें भी देखें


sendEmail(recipient, subject, body)

ईमेल मैसेज भेजता है.

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

पैरामीटर

नामTypeब्यौरा
recipientStringईमेल पाने वालों के पते, जिन्हें कॉमा लगाकर अलग किया गया हो
subjectStringसब्जेक्ट लाइन
bodyStringईमेल का मुख्य हिस्सा

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

sendEmail(recipient, subject, body, options)

वैकल्पिक तर्कों के साथ ईमेल मैसेज भेजता है.

// 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]
});

पैरामीटर

नामTypeब्यौरा
recipientStringईमेल पाने वालों के पते, जिन्हें कॉमा लगाकर अलग किया गया हो
subjectStringसब्जेक्ट लाइन
bodyStringईमेल का मुख्य हिस्सा
optionsObjectयह एक JavaScript ऑब्जेक्ट है, जो बेहतर पैरामीटर के बारे में बताता है, जैसा कि नीचे दिया गया है

उन्नत पैरामीटर

नामTypeब्यौरा
attachmentsBlobSource[]ईमेल के साथ भेजने के लिए फ़ाइलों का कलेक्शन (उदाहरण देखें)
bccStringगुप्त कॉपी फ़ील्ड में ईमेल पतों की कॉमा-सेपरेटेड लिस्ट
ccStringकॉपी में ईमेल पतों की कॉमा-सेपरेटेड लिस्ट
htmlBodyStringअगर सेट किया जाता है, तो एचटीएमएल रेंडर करने की सुविधा वाले डिवाइस, ज़रूरी तर्क के बजाय इसका इस्तेमाल करेंगे. अगर आपके पास अपने ईमेल के लिए इनलाइन इमेज हैं, तो एचटीएमएल बॉडी में एक वैकल्पिक inlineImages फ़ील्ड भी जोड़ा जा सकता है
inlineImagesObjectयह एक JavaScript ऑब्जेक्ट है, जिसमें इमेज कुंजी (String) से इमेज डेटा (BlobSource) को मैप किया जाता है. इसके लिए यह माना जाता है कि htmlBody पैरामीटर का इस्तेमाल किया जाता है और इसमें <img src="cid:imageKey" /> फ़ॉर्मैट में इन इमेज के रेफ़रंस शामिल हैं
nameStringईमेल भेजने वाले का नाम (डिफ़ॉल्ट: उपयोगकर्ता का नाम)
noReplyBooleantrue, अगर ईमेल पाने वाले लोगों को ईमेल का जवाब देने से रोकने के लिए, ऐसे सामान्य ईमेल पते से भेजा गया हो जिसका जवाब नहीं दिया जा सकता. इस विकल्प का इस्तेमाल सिर्फ़ Google Workspace खातों के लिए किया जा सकता है, Gmail का इस्तेमाल करने वाले लोगों के लिए नहीं
replyToStringजवाब देने के डिफ़ॉल्ट पते के तौर पर इस्तेमाल करने के लिए, कोई ईमेल पता (डिफ़ॉल्ट: उपयोगकर्ता का ईमेल पता)

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

इन्हें भी देखें


sendEmail(to, replyTo, subject, body)

ईमेल मैसेज भेजता है. इस तरीके से उपयोगकर्ता, भेजे गए मैसेज के लिए 'जवाब देने का पता' आसानी से तय कर सकता है. यह पता भेजने वाले व्यक्ति से अलग हो सकता है.

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

पैरामीटर

नामTypeब्यौरा
toStringईमेल पाने वालों के पते, जिन्हें कॉमा लगाकर अलग किया गया हो
replyToStringईमेल पाने का डिफ़ॉल्ट पता
subjectStringसब्जेक्ट लाइन
bodyStringईमेल का मुख्य हिस्सा सादे टेक्स्ट में

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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