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()NamespaceNamespace बनाता है, जो किसी असल नेमस्पेस की अनुपस्थिति को दिखाता है.
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 नोड बनाता है.

पैरामीटर

नामटाइपब्यौरा
elementNameStringDocType डिक्लेरेशन में बताए जाने वाले रूट Element नोड का नाम

वापसी का टिकट

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

createDocType(elementName, systemId)

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

पैरामीटर

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

वापसी का टिकट

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

createDocType(elementName, publicId, systemId)

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

पैरामीटर

नामटाइपब्यौरा
elementNameStringDocType डिक्लेरेशन में बताए जाने वाले रूट Element नोड का नाम
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 — नया दस्तावेज़