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 के लिए कोटा सेवाएं.

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: "[email protected]",
    subject: "Logos",
    htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" +
              "inline YouTube Logo <img src='cid:youtubeLogo'>",
    inlineImages:
      {
        googleLogo: googleLogoBlob,
        youtubeLogo: youtubeLogoBlob
      }
  });
}

पैरामीटर

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

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

नामटाइपब्यौरा
attachmentsBlobSource[]एक ईमेल के साथ भेजने के लिए फ़ाइलों का कलेक्शन
bccString‘गुप्त कॉपी’ फ़ील्ड में डाले जाने वाले ईमेल पतों की सूची
bodyStringईमेल का मुख्य हिस्सा
ccStringईमेल पतों की कॉमा-सेपरेटेड लिस्ट
htmlBodyStringऔर सेट हो, तो HTML रेंडर करने में सक्षम डिवाइस इसके बजाय इसका उपयोग करेंगे कानूनी विरोध सबमिट करें; तो आपके पास एचटीएमएल में एक वैकल्पिक 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("[email protected]",
                  "TPS reports",
                  "Where are the TPS reports?");

पैरामीटर

नामटाइपब्यौरा
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('[email protected]', 'Attachment example', 'Two files are attached.', {
    name: 'Automatic Emailer Script',
    attachments: [file.getAs(MimeType.PDF), blob]
});

पैरामीटर

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

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

नामटाइपब्यौरा
attachmentsBlobSource[]एक ईमेल के साथ भेजी जाने वाली फ़ाइलों का कलेक्शन (उदाहरण देखें)
bccString‘गुप्त कॉपी’ फ़ील्ड में डाले जाने वाले ईमेल पतों की सूची
ccStringईमेल पतों की कॉमा-सेपरेटेड लिस्ट
htmlBodyStringऔर सेट हो, तो HTML रेंडर करने में सक्षम डिवाइस इसके बजाय इसका उपयोग करेंगे कानूनी विरोध सबमिट करें; तो आपके पास एचटीएमएल में एक वैकल्पिक 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("[email protected]",
                  "[email protected]",
                  "TPS report status",
                  "What is the status of those TPS reports?");

पैरामीटर

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

अनुमति देना

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

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