Class XmlService

XmlService

इस सेवा की मदद से, स्क्रिप्ट को एक्सएमएल दस्तावेज़ों को पार्स करने, उनमें नेविगेट करने, और उन्हें प्रोग्राम के हिसाब से बनाने की अनुमति मिलती है. 

// Log the title and labels for the first page of blog posts on the
// Google Workspace Developer blog.
function parseXml() {
  const url = 'https://gsuite-developers.googleblog.com/atom.xml';
  const xml = UrlFetchApp.fetch(url).getContentText();
  const document = XmlService.parse(xml);
  const root = document.getRootElement();
  const atom = XmlService.getNamespace('http://www.w3.org/2005/Atom');

  const entries = root.getChildren('entry', atom);
  for (let i = 0; i < entries.length; i++) {
    const title = entries[i].getChild('title', atom).getText();
    const categoryElements = entries[i].getChildren('category', atom);
    const labels = [];
    for (let j = 0; j < categoryElements.length; j++) {
      labels.push(categoryElements[j].getAttribute('term').getValue());
    }
    Logger.log('%s (%s)', title, labels.join(', '));
  }
}

// Create and log an XML representation of the threads in your Gmail inbox.
function createXml() {
  const root = XmlService.createElement('threads');
  const threads = GmailApp.getInboxThreads();
  for (let i = 0; i < threads.length; i++) {
    const child =
        XmlService.createElement('thread')
            .setAttribute('messageCount', threads[i].getMessageCount())
            .setAttribute('isUnread', threads[i].isUnread())
            .setText(threads[i].getFirstMessageSubject());
    root.addContent(child);
  }
  const document = XmlService.createDocument(root);
  const xml = XmlService.getPrettyFormat().format(document);
  Logger.log(xml);
}

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
ContentTypesContentTypeयह एक इन्यूमरेशन है, जो एक्सएमएल कॉन्टेंट नोड के टाइप दिखाता है.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
createCdata(text)Cdataयह दी गई वैल्यू के साथ, बिना अटैच किया गया CDATASection नोड बनाता है.
createComment(text)Commentयह दी गई वैल्यू के साथ, बिना अटैच किया गया Comment नोड बनाता है.
createDocType(elementName)DocTypeयह दिए गए नाम के साथ, रूट Element नोड के लिए एक अनअटैच किया गया DocumentType नोड बनाता है.
createDocType(elementName, systemId)DocTypeयह दिए गए नाम के साथ, रूट Element नोड के लिए एक अनअटैच किया गया DocumentType नोड बनाता है. साथ ही, बाहरी सबसेट डेटा के लिए दिया गया सिस्टम आईडी बनाता है.
createDocType(elementName, publicId, systemId)DocTypeयह दिए गए नाम के साथ, रूट Element नोड के लिए एक अनअटैच किया गया DocumentType नोड बनाता है. साथ ही, बाहरी सबसेट डेटा के लिए दिया गया सार्वजनिक आईडी और सिस्टम आईडी बनाता है.
createDocument()Documentयह एक खाली एक्सएमएल दस्तावेज़ बनाता है.
createDocument(rootElement)Documentयह दिए गए रूट Element नोड के साथ एक एक्सएमएल दस्तावेज़ बनाता है.
createElement(name)Elementयह दिए गए लोकल नाम के साथ, बिना अटैच किया गया Element नोड बनाता है. इसमें कोई नेमस्पेस नहीं होता.
createElement(name, namespace)Elementयह दिए गए लोकल नेम और नेमस्पेस के साथ, बिना अटैच किया गया Element नोड बनाता है.
createText(text)Textयह दी गई वैल्यू के साथ, बिना अटैच किया गया Text नोड बनाता है.
getCompactFormat()Formatयह फ़ंक्शन, कॉम्पैक्ट एक्सएमएल दस्तावेज़ को आउटपुट करने के लिए Format ऑब्जेक्ट बनाता है.
getNamespace(uri)Namespaceदिए गए यूआरआई के साथ Namespace बनाता है.
getNamespace(prefix, uri)Namespaceयह दिए गए प्रीफ़िक्स और यूआरआई के साथ Namespace बनाता है.
getNoNamespace()Namespaceयह एक ऐसा Namespace बनाता है जो किसी असली नेमस्पेस के मौजूद न होने की जानकारी देता है.
getPrettyFormat()Formatयह फ़ंक्शन, किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले एक्सएमएल दस्तावेज़ को आउटपुट करने के लिए, Format ऑब्जेक्ट बनाता है.
getRawFormat()Formatयह फ़ंक्शन, रॉ एक्सएमएल दस्तावेज़ को आउटपुट करने के लिए Format ऑब्जेक्ट बनाता है.
getXmlNamespace()Namespaceयह स्टैंडर्ड xml प्रीफ़िक्स के साथ Namespace बनाता है.
parse(xml)Documentयह दिए गए एक्सएमएल से Document बनाता है. हालांकि, यह एक्सएमएल की पुष्टि नहीं करता.

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

createCdata(text)

यह दी गई वैल्यू के साथ, बिना अटैच किया गया CDATASection नोड बनाता है.

पैरामीटर

नामटाइपब्यौरा
textStringसेट की जाने वाली वैल्यू.

वापसी का टिकट

Cdata — नया बनाया गया CDATASection नोड.

createComment(text)

यह दी गई वैल्यू के साथ, बिना अटैच किया गया Comment नोड बनाता है.

पैरामीटर

नामटाइपब्यौरा
textStringसेट की जाने वाली वैल्यू.

वापसी का टिकट

Comment — नया बनाया गया Comment नोड.

createDocType(elementName)

यह दिए गए नाम के साथ, रूट Element नोड के लिए एक अनअटैच किया गया DocumentType नोड बनाता है.

पैरामीटर

नामटाइपब्यौरा
elementNameStringरूट Element नोड का नाम, जिसे DocType डिक्लेरेशन में तय करना है.

वापसी का टिकट

DocType — नया बनाया गया DocumentType नोड.

createDocType(elementName, systemId)

यह दिए गए नाम के साथ, रूट Element नोड के लिए एक अनअटैच किया गया DocumentType नोड बनाता है. साथ ही, बाहरी सबसेट डेटा के लिए दिया गया सिस्टम आईडी बनाता है.

पैरामीटर

नामटाइपब्यौरा
elementNameStringरूट Element नोड का नाम, जिसे DocType डिक्लेरेशन में तय करना है.
systemIdStringसेट करने के लिए, बाहरी सबसेट डेटा का सिस्टम आईडी.

वापसी का टिकट

DocType — नया बनाया गया DocumentType नोड.

createDocType(elementName, publicId, systemId)

यह दिए गए नाम के साथ, रूट Element नोड के लिए एक अनअटैच किया गया DocumentType नोड बनाता है. साथ ही, बाहरी सबसेट डेटा के लिए दिया गया सार्वजनिक आईडी और सिस्टम आईडी बनाता है.

पैरामीटर

नामटाइपब्यौरा
elementNameStringरूट Element नोड का नाम, जिसे DocType डिक्लेरेशन में तय करना है.
publicIdStringसेट किए जाने वाले बाहरी सबसेट डेटा का सार्वजनिक आईडी.
systemIdStringसेट करने के लिए, बाहरी सबसेट डेटा का सिस्टम आईडी.

वापसी का टिकट

DocType — नया बनाया गया DocumentType नोड.

createDocument()

यह एक खाली एक्सएमएल दस्तावेज़ बनाता है.

वापसी का टिकट

Document — नया दस्तावेज़.

createDocument(rootElement)

यह दिए गए रूट Element नोड के साथ एक एक्सएमएल दस्तावेज़ बनाता है.

पैरामीटर

नामटाइपब्यौरा
rootElementElementसेट करने के लिए रूट Element नोड.

वापसी का टिकट

Document — नया दस्तावेज़.

createElement(name)

यह दिए गए लोकल नाम के साथ, बिना अटैच किया गया Element नोड बनाता है. इसमें कोई नेमस्पेस नहीं होता.

पैरामीटर

नामटाइपब्यौरा
nameStringसेट करने के लिए स्थानीय नाम.

वापसी का टिकट

Element — नया बनाया गया Element नोड.

createElement(name, namespace)

यह दिए गए लोकल नेम और नेमस्पेस के साथ, बिना अटैच किया गया Element नोड बनाता है.

पैरामीटर

नामटाइपब्यौरा
nameStringसेट करने के लिए स्थानीय नाम.
namespaceNamespaceसेट करने के लिए नेमस्पेस.

वापसी का टिकट

Element — नया बनाया गया Element नोड.

createText(text)

यह दी गई वैल्यू के साथ, बिना अटैच किया गया Text नोड बनाता है.

पैरामीटर

नामटाइपब्यौरा
textStringसेट की जाने वाली वैल्यू.

वापसी का टिकट

Text — नया बनाया गया Text नोड.

getCompactFormat()

यह फ़ंक्शन, कॉम्पैक्ट एक्सएमएल दस्तावेज़ को आउटपुट करने के लिए Format ऑब्जेक्ट बनाता है. फ़ॉर्मेटर, डिफ़ॉल्ट रूप से UTF-8 एन्कोडिंग, कोई इंडेंटेशन, और कोई अतिरिक्त लाइन ब्रेक इस्तेमाल करता है. हालांकि, इसमें एक्सएमएल एलान और उसकी एन्कोडिंग शामिल होती है. 

// Log an XML document in compact form.
const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
const document = XmlService.parse(xml);
const output = XmlService.getCompactFormat().format(document);
Logger.log(output);

वापसी का टिकट

Format — नया फ़ॉर्मेटर.

getNamespace(uri)

दिए गए यूआरआई के साथ Namespace बनाता है.

पैरामीटर

नामटाइपब्यौरा
uriStringनेमस्पेस के लिए यूआरआई.

वापसी का टिकट

Namespace — नया बनाया गया नेमस्पेस.

getNamespace(prefix, uri)

यह दिए गए प्रीफ़िक्स और यूआरआई के साथ Namespace बनाता है.

पैरामीटर

नामटाइपब्यौरा
prefixStringनेमस्पेस के लिए प्रीफ़िक्स.
uriStringनेमस्पेस के लिए यूआरआई.

वापसी का टिकट

Namespace — नया बनाया गया नेमस्पेस.

getNoNamespace()

यह एक ऐसा Namespace बनाता है जो किसी असली नेमस्पेस के मौजूद न होने की जानकारी देता है.

वापसी का टिकट

Namespace — नया बनाया गया नेमस्पेस.

getPrettyFormat()

यह फ़ंक्शन, किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले एक्सएमएल दस्तावेज़ को आउटपुट करने के लिए, Format ऑब्जेक्ट बनाता है. फ़ॉर्मेटर, डिफ़ॉल्ट रूप से UTF-8 एन्कोडिंग, दो स्पेस इंडेंटेशन, हर नोड के बाद \r\n लाइन सेपरेटर का इस्तेमाल करता है. साथ ही, इसमें एक्सएमएल डिक्लेरेशन और उसकी एन्कोडिंग शामिल होती है. 

// Log an XML document in human-readable form.
const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
const document = XmlService.parse(xml);
const output = XmlService.getPrettyFormat().format(document);
Logger.log(output);

वापसी का टिकट

Format — नया फ़ॉर्मेटर.

getRawFormat()

यह फ़ंक्शन, रॉ एक्सएमएल दस्तावेज़ को आउटपुट करने के लिए Format ऑब्जेक्ट बनाता है. फ़ॉर्मैट करने वाला टूल, डिफ़ॉल्ट रूप से UTF-8 एन्कोडिंग का इस्तेमाल करता है. इसमें कोई इंडेंटेशन नहीं होता और एक्सएमएल दस्तावेज़ में दिए गए लाइन ब्रेक के अलावा कोई अन्य लाइन ब्रेक नहीं होता. साथ ही, इसमें एक्सएमएल डिक्लेरेशन और उसकी एन्कोडिंग शामिल होती है. 

// Log an XML document in raw form.
const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
const document = XmlService.parse(xml);
const output = XmlService.getRawFormat().format(document);
Logger.log(output);

वापसी का टिकट

Format — नया फ़ॉर्मेटर.

getXmlNamespace()

यह स्टैंडर्ड xml प्रीफ़िक्स के साथ Namespace बनाता है.

वापसी का टिकट

Namespace — नया बनाया गया नेमस्पेस.

parse(xml)

यह दिए गए एक्सएमएल से Document बनाता है. हालांकि, यह एक्सएमएल की पुष्टि नहीं करता. 

const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
const doc = XmlService.parse(xml);

पैरामीटर

नामटाइपब्यौरा
xmlStringपार्स करने के लिए एक्सएमएल.

वापसी का टिकट

Document — नया दस्तावेज़.