Class GmailAttachment

GmailAttachment

Gmail का एक अटैचमेंट. यह एक सामान्य Blob है. हालांकि, इसमें getSize() एक और तरीका है जो getBytes().length पर कॉल करने से ज़्यादा तेज़ है. साथ ही, इसे Gmail के रीड कोटा में शामिल नहीं किया जाता.

// Logs information about any attachments in the first 100 inbox threads.
var threads = GmailApp.getInboxThreads(0, 100);
var msgs = GmailApp.getMessagesForThreads(threads);
for (var i = 0 ; i < msgs.length; i++) {
  for (var j = 0; j < msgs[i].length; j++) {
    var attachments = msgs[i][j].getAttachments();
    for (var k = 0; k < attachments.length; k++) {
      Logger.log('Message "%s" contains the attachment "%s" (%s bytes)',
                 msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize());
    }
  }
}

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
copyBlob()Blobइस ब्लॉब की कॉपी दिखाता है.
getAs(contentType)Blobइस ऑब्जेक्ट के अंदर डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाएं.
getBytes()Byte[]इस ब्लॉब में सेव किए गए डेटा को ऐक्सेस किया जाता है.
getContentType()Stringइस ब्लॉब में बाइट के कॉन्टेंट टाइप की जानकारी मिलती है.
getDataAsString()Stringयह UTF-8 एन्कोडिंग वाली स्ट्रिंग के तौर पर इस ब्लॉब का डेटा लेता है.
getDataAsString(charset)Stringतय की गई एन्कोडिंग के साथ इस ब्लॉब के डेटा को स्ट्रिंग के रूप में लेता है.
getHash()Stringइस अटैचमेंट के लिए SHA1 कॉन्टेंट हैश मिलता है.
getName()Stringइस ब्लॉब का नाम मिला है.
getSize()Integerइस अटैचमेंट के साइज़ की जानकारी मिलती है.
isGoogleType()Booleanयह बताता है कि यह ब्लॉब, Google Workspace की फ़ाइल (Sheets, Docs वगैरह) है या नहीं.
setBytes(data)Blobइस ब्लॉब में सेव किए गए डेटा को सेट करता है.
setContentType(contentType)Blobइस ब्लॉब में बाइट का कॉन्टेंट टाइप सेट करता है.
setContentTypeFromExtension()Blobयह नीति फ़ाइल एक्सटेंशन के आधार पर, इस ब्लॉब में बाइट के कॉन्टेंट का टाइप सेट करती है.
setDataFromString(string)BlobUTF-8 एन्कोडिंग वाली स्ट्रिंग से इस ब्लॉब का डेटा सेट करता है.
setDataFromString(string, charset)Blobतय की गई एन्कोडिंग वाली स्ट्रिंग से इस ब्लॉब का डेटा सेट करता है.
setName(name)Blobइस ब्लॉब का नाम सेट करता है.

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

copyBlob()

इस ब्लॉब की कॉपी दिखाता है.

रिटर्न

Blob — नई कॉपी.


getAs(contentType)

इस ऑब्जेक्ट के अंदर डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाएं. इस तरीका से फ़ाइल नाम में सही एक्सटेंशन जोड़ा जा सकता है—उदाहरण के लिए, "myfile.pdf". हालांकि, यह माना जाता है कि फ़ाइल नाम का वह हिस्सा जो पिछली अवधि (अगर कोई है) के बाद आता है, तो वह मौजूदा एक्सटेंशन है जिसे बदला जाना चाहिए. इस वजह से, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" हो जाता है.

कन्वर्ज़न के रोज़ के कोटा देखने के लिए, Google Services के लिए कोटा देखें. हाल ही में बनाए गए Google Workspace डोमेन पर, कुछ समय के लिए सख्त कोटे लागू हो सकते हैं.

पैरामीटर

नामTypeब्यौरा
contentTypeStringवह MIME टाइप जिसमें बदलना है. ज़्यादातर ब्लॉब के लिए, सिर्फ़ 'application/pdf' ही मान्य विकल्प है. BMP, GIF, JPEG या PNG फ़ॉर्मैट में मौजूद इमेज के लिए, 'image/bmp', 'image/gif', 'image/jpeg' या 'image/png' में से कोई भी मान्य है.

रिटर्न

Blob — ब्लॉब के तौर पर डेटा.


getBytes()

इस ब्लॉब में सेव किए गए डेटा को ऐक्सेस किया जाता है.

रिटर्न

Byte[] — सेव की गई बाइट.


getContentType()

इस ब्लॉब में बाइट के कॉन्टेंट टाइप की जानकारी मिलती है.

रिटर्न

String — इस डेटा का कॉन्टेंट टाइप, अगर आपको पता है या null.


getDataAsString()

यह UTF-8 एन्कोडिंग वाली स्ट्रिंग के तौर पर इस ब्लॉब का डेटा लेता है.

रिटर्न

String — डेटा, स्ट्रिंग के तौर पर होता है.


getDataAsString(charset)

तय की गई एन्कोडिंग के साथ इस ब्लॉब के डेटा को स्ट्रिंग के रूप में लेता है.

पैरामीटर

नामTypeब्यौरा
charsetStringइस ब्लॉब में स्ट्रिंग के रूप में डेटा को कोड में बदलने के लिए इस्तेमाल किया जाने वाला वर्णसेट.

रिटर्न

String — डेटा, स्ट्रिंग के तौर पर होता है.


getHash()

इस अटैचमेंट के लिए SHA1 कॉन्टेंट हैश मिलता है. यह तरीका, Gmail के पढ़ने के कोटा में शामिल नहीं होता.

रिटर्न

String — SHA1 कॉन्टेंट हैश, स्ट्रिंग के तौर पर.

अनुमति देना

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

  • https://mail.google.com/

getName()

इस ब्लॉब का नाम मिला है.

रिटर्न

String — इस डेटा का नाम, अगर आपको पता है या null.


getSize()

इस अटैचमेंट के साइज़ की जानकारी मिलती है. यह तरीका getBytes().length को कॉल करने से ज़्यादा तेज़ है. साथ ही, इसे Gmail के पढ़ने के कोटा में शामिल नहीं किया जाता.

रिटर्न

Integer — अटैचमेंट का साइज़, बाइट में.

अनुमति देना

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

  • https://mail.google.com/

isGoogleType()

यह बताता है कि यह ब्लॉब, Google Workspace की फ़ाइल (Sheets, Docs वगैरह) है या नहीं.

रिटर्न

Booleantrue अगर यह ब्लॉब Google Workspace फ़ाइल है; अगर नहीं है, तो false.


setBytes(data)

इस ब्लॉब में सेव किए गए डेटा को सेट करता है.

पैरामीटर

नामTypeब्यौरा
dataByte[]नया डेटा.

रिटर्न

Blob — यह ब्लॉब, चेन बनाने के लिए है.


setContentType(contentType)

इस ब्लॉब में बाइट का कॉन्टेंट टाइप सेट करता है.

पैरामीटर

नामTypeब्यौरा
contentTypeStringनया ContentType.

रिटर्न

Blob — यह ब्लॉब, चेन बनाने के लिए है.


setContentTypeFromExtension()

यह नीति फ़ाइल एक्सटेंशन के आधार पर, इस ब्लॉब में बाइट के कॉन्टेंट का टाइप सेट करती है. अगर इसके एक्सटेंशन से इसका अनुमान नहीं लगाया जा सकता, तो ContentType null है.

रिटर्न

Blob — यह ब्लॉब, चेन बनाने के लिए है.


setDataFromString(string)

UTF-8 एन्कोडिंग वाली स्ट्रिंग से इस ब्लॉब का डेटा सेट करता है.

पैरामीटर

नामTypeब्यौरा
stringStringस्ट्रिंग डेटा.

रिटर्न

Blob — यह ब्लॉब, चेन बनाने के लिए है.


setDataFromString(string, charset)

तय की गई एन्कोडिंग वाली स्ट्रिंग से इस ब्लॉब का डेटा सेट करता है.

पैरामीटर

नामTypeब्यौरा
stringStringस्ट्रिंग डेटा.
charsetStringस्ट्रिंग को बाइट में समझने के लिए, इस्तेमाल किया जाने वाला वर्णसेट.

रिटर्न

Blob — यह ब्लॉब, चेन बनाने के लिए है.


setName(name)

इस ब्लॉब का नाम सेट करता है.

पैरामीटर

नामTypeब्यौरा
nameStringनया नाम.

रिटर्न

Blob — यह ब्लॉब, चेन बनाने के लिए है.

काम न करने वाले तरीके