Class GmailAttachment

Gmailअटैचमेंट

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

// Logs information about any attachments in the first 100 inbox threads.
const threads = GmailApp.getInboxThreads(0, 100);
const msgs = GmailApp.getMessagesForThreads(threads);
for (let i = 0; i < msgs.length; i++) {
  for (let j = 0; j < msgs[i].length; j++) {
    const attachments = msgs[i][j].getAttachments();
    for (let 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 की सेवाओं के लिए कोटे देखें. नए बनाए गए Google Workspace डोमेन पर, कुछ समय के लिए ज़्यादा कड़े कोटे लागू हो सकते हैं.

पैरामीटर

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

वापसी का टिकट

Blob — डेटा को ब्लॉब के तौर पर दिखाया गया है.


getBytes()

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

वापसी का टिकट

Byte[] — सेव किए गए बाइट.


getContentType()

इस ब्लॉब में मौजूद बाइट का कॉन्टेंट टाइप दिखाता है.

वापसी का टिकट

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


getDataAsString()

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

वापसी का टिकट

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


getDataAsString(charset)

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

पैरामीटर

नामटाइपब्यौरा
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 वगैरह) है या नहीं.

वापसी का टिकट

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


setBytes(data)

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

पैरामीटर

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

वापसी का टिकट

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


setContentType(contentType)

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

पैरामीटर

नामटाइपब्यौरा
contentTypeStringनया contentType.

वापसी का टिकट

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


setContentTypeFromExtension()

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

वापसी का टिकट

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


setDataFromString(string)

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

पैरामीटर

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

वापसी का टिकट

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


setDataFromString(string, charset)

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

पैरामीटर

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

वापसी का टिकट

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


setName(name)

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

पैरामीटर

नामटाइपब्यौरा
nameStringनया नाम.

वापसी का टिकट

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

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