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

const 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() {
  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,
    },
  });
}

पैरामीटर

नामटाइपब्यौरा
messageObjectईमेल मैसेज दिखाने वाला JavaScript ऑब्जेक्ट

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

नामटाइपब्यौरा
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?',
);

पैरामीटर

नामटाइपब्यौरा
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.
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],
    },
);

पैरामीटर

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

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

नामटाइपब्यौरा
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?',
);

पैरामीटर

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

अनुमति देना

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

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