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);
}

प्रॉपर्टी

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

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
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 नोड बनाता है.

पैरामीटर

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

वापसी का टिकट

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

---

createComment(text)

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

पैरामीटर

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

वापसी का टिकट

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

---

createDocType(elementName)

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

पैरामीटर

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

वापसी का टिकट

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

---

createDocType(elementName, systemId)

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

पैरामीटर

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

वापसी का टिकट

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

---

createDocType(elementName, publicId, systemId)

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

पैरामीटर

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

वापसी का टिकट

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

---

createDocument()

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

वापसी का टिकट

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

---

createDocument(rootElement)

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

पैरामीटर

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

वापसी का टिकट

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

---

createElement(name)

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

पैरामीटर

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

वापसी का टिकट

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

---

createElement(name, namespace)

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

पैरामीटर

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

वापसी का टिकट

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

---

createText(text)

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

पैरामीटर

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

वापसी का टिकट

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 बनाता है.

पैरामीटर

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

वापसी का टिकट

Namespace — यह नया नेमस्पेस है.

---

getNamespace(prefix, uri)

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

पैरामीटर

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

वापसी का टिकट

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);

पैरामीटर

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

वापसी का टिकट

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