XML Service

एक्सएमएल सेवा

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

// Log the title and labels for the first page of blog posts on
// Google's The Keyword blog.
function parseXml() {
  let url = 'https://blog.google/rss/';
  let xml = UrlFetchApp.fetch(url).getContentText();
  let document = XmlService.parse(xml);
  let root = document.getRootElement();

  let channel = root.getChild('channel');
  let items = channel.getChildren('item');
  items.forEach(item => {
    let title = item.getChild('title').getText();
    let categories = item.getChildren('category');
    let labels = categories.map(category => category.getText());
    console.log('%s (%s)', title, labels.join(', '));
  });
}

// Create and log an XML representation of first 10 threads in your Gmail inbox.
function createXml() {
  let root = XmlService.createElement('threads');
  let threads = GmailApp.getInboxThreads()
  threads = threads.slice(0,10); // Just the first 10
  threads.forEach(thread => {
    let child = XmlService.createElement('thread')
        .setAttribute('messageCount', thread.getMessageCount())
        .setAttribute('isUnread', thread.isUnread())
        .setText(thread.getFirstMessageSubject());
    root.addContent(child);
  });
  let document = XmlService.createDocument(root);
  let xml = XmlService.getPrettyFormat().format(document);
  console.log(xml);
}

क्लास

नामसंक्षिप्त विवरण
Attributeएक्सएमएल एट्रिब्यूट का उदाहरण.
Cdataएक्सएमएल CDATASection नोड को दिखाने का तरीका.
Commentएक्सएमएल Comment नोड को दिखाने का तरीका.
Contentकिसी सामान्य एक्सएमएल नोड को दिखाने का तरीका.
ContentTypeएक्सएमएल कॉन्टेंट नोड के टाइप दिखाने वाला एनोटेशन.
DocTypeएक्सएमएल DocumentType नोड को दिखाने का तरीका.
Documentएक्सएमएल दस्तावेज़ का उदाहरण.
Elementएक्सएमएल Element नोड को दिखाने का तरीका.
EntityRefएक्सएमएल EntityReference नोड को दिखाने का तरीका.
Formatएक्सएमएल दस्तावेज़ को आउटपुट करने के लिए फ़ॉर्मैटर. इसमें पहले से तय तीन फ़ॉर्मैट होते हैं, जिन्हें अपनी पसंद के मुताबिक बनाया जा सकता है.
Namespaceएक्सएमएल नेमस्पेस का इलस्ट्रेशन.
ProcessingInstructionएक्सएमएल ProcessingInstruction नोड को दिखाने का तरीका.
Textएक्सएमएल Text नोड को दिखाने का तरीका.
XmlServiceइस सेवा की मदद से, स्क्रिप्ट एक्सएमएल दस्तावेज़ों को पार्स कर सकती हैं, उनमें नेविगेट कर सकती हैं, और उन्हें प्रोग्राम के हिसाब से बना सकती हैं.

Attribute

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getName()Stringएट्रिब्यूट का स्थानीय नाम दिखाता है.
getNamespace()Namespaceएट्रिब्यूट का नेमस्पेस पाता है.
getValue()Stringएट्रिब्यूट की वैल्यू पाता है.
setName(name)Attributeएट्रिब्यूट का स्थानीय नाम सेट करता है.
setNamespace(namespace)Attributeएट्रिब्यूट के लिए नेमस्पेस सेट करता है.
setValue(value)Attributeएट्रिब्यूट की वैल्यू सेट करता है.

Cdata

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
append(text)Textदिए गए टेक्स्ट को नोड में पहले से मौजूद किसी भी कॉन्टेंट में जोड़ता है.
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getText()StringText नोड की टेक्स्ट वैल्यू दिखाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.
setText(text)TextText नोड की टेक्स्ट वैल्यू सेट करता है.

Comment

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getText()StringComment नोड की टेक्स्ट वैल्यू दिखाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.
setText(text)CommentComment नोड की टेक्स्ट वैल्यू सेट करता है.

Content

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
asCdata()Cdataऑटोकंप्लीट के लिए, नोड को CDATASection नोड के तौर पर कास्ट करता है.
asComment()Commentऑटोकंप्लीट के लिए, नोड को Comment नोड के तौर पर कास्ट करता है.
asDocType()DocTypeऑटोकंप्लीट के लिए, नोड को DocumentType नोड के तौर पर कास्ट करता है.
asElement()Elementऑटोकंप्लीट के लिए, नोड को Element नोड के तौर पर कास्ट करता है.
asEntityRef()EntityRefऑटोकंप्लीट के लिए, नोड को EntityReference नोड के तौर पर कास्ट करता है.
asProcessingInstruction()ProcessingInstructionऑटोकंप्लीट के लिए, नोड को ProcessingInstruction नोड के तौर पर कास्ट करता है.
asText()Textऑटोकंप्लीट के लिए, नोड को Text नोड के तौर पर कास्ट करता है.
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getType()ContentTypeइससे नोड का कॉन्टेंट टाइप पता चलता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.

ContentType

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
CDATAEnumएक्सएमएल CDATASection नोड.
COMMENTEnumएक्सएमएल Comment नोड.
DOCTYPEEnumएक्सएमएल DocumentType नोड.
ELEMENTEnumएक्सएमएल Element नोड.
ENTITYREFEnumएक्सएमएल EntityReference नोड.
PROCESSINGINSTRUCTIONEnumएक्सएमएल ProcessingInstruction नोड.
TEXTEnumएक्सएमएल Text नोड.

DocType

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getElementName()StringDocType एलान में बताए गए रूट Element नोड का नाम दिखाता है.
getInternalSubset()StringDocumentType नोड के लिए, इंटरनल सबसेट का डेटा पाता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getPublicId()StringDocumentType नोड के लिए, एक्सटर्नल सबसेट डेटा का सार्वजनिक आईडी पाता है.
getSystemId()StringDocumentType नोड के लिए, बाहरी सबसेट डेटा का सिस्टम आईडी पाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.
setElementName(name)DocTypeDocType एलान में बताने के लिए, रूट Element नोड का नाम सेट करता है.
setInternalSubset(data)DocTypeDocumentType नोड के लिए इंटरनल सबसेट डेटा सेट करता है.
setPublicId(id)DocTypeDocumentType नोड के लिए, बाहरी सबसेट डेटा का सार्वजनिक आईडी सेट करता है.
setSystemId(id)DocTypeDocumentType नोड के लिए, बाहरी सबसेट डेटा का सिस्टम आईडी सेट करता है.

Document

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addContent(content)Documentदिए गए नोड को दस्तावेज़ के आखिर में जोड़ता है.
addContent(index, content)Documentदिए गए इंडेक्स पर, दिए गए नोड को दस्तावेज़ के उन सभी नोड के बीच में डालता है जो उसके चाइल्ड होते हैं.
cloneContent()Content[]दस्तावेज़ के सभी चाइल्ड नोड की अटैच नहीं की गई कॉपी बनाता है.
detachRootElement()Elementदस्तावेज़ के रूट Element नोड को अलग करता है और उसे दिखाता है.
getAllContent()Content[]दस्तावेज़ के चाइल्ड नोड दिखाता है.
getContent(index)Contentदस्तावेज़ के बच्चों के तौर पर मौजूद सभी नोड में से, दिए गए इंडेक्स पर मौजूद नोड को पाता है.
getContentSize()Integerदस्तावेज़ के चाइल्ड नोड की संख्या दिखाता है.
getDescendants()Content[]दस्तावेज़ के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड को उसी क्रम में दिखाता है जिस क्रम में वे दस्तावेज़ में दिखते हैं.
getDocType()DocTypeदस्तावेज़ का DocType एलान पाता है.
getRootElement()Elementदस्तावेज़ का रूट Element नोड दिखाता है.
hasRootElement()Booleanयह पता लगाता है कि दस्तावेज़ में रूट Element नोड है या नहीं.
removeContent()Content[]दस्तावेज़ के चाइल्ड नोड हटाता है.
removeContent(content)Booleanअगर दिया गया नोड, दस्तावेज़ का चाइल्ड है, तो उसे हटा देता है.
removeContent(index)Contentदस्तावेज़ के चाइल्ड नोड में से, दिए गए इंडेक्स पर मौजूद नोड को हटाता है.
setDocType(docType)Documentदस्तावेज़ का DocType एलान सेट करता है.
setRootElement(element)Documentदस्तावेज़ का रूट Element नोड सेट करता है.

Element

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addContent(content)Elementदिए गए नोड को Element नोड के आखिरी चाइल्ड के तौर पर जोड़ता है.
addContent(index, content)Elementदिए गए इंडेक्स पर, दिए गए नोड को उन सभी नोड के बीच में डालता है जो Element नोड के चाइल्ड होते हैं.
cloneContent()Content[]{@code Element} नोड के चाइल्ड नोड की अटैच नहीं की गई कॉपी बनाता है.
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getAllContent()Content[]{@code Element} नोड के चाइल्ड एलिमेंट दिखाता है.
getAttribute(name)Attributeदिए गए नाम और बिना नेमस्पेस वाले इस Element नोड के लिए एट्रिब्यूट पाता है.
getAttribute(name, namespace)Attributeदिए गए नाम और नेमस्पेस वाले इस Element नोड के लिए एट्रिब्यूट पाता है.
getAttributes()Attribute[]इस Element नोड के सभी एट्रिब्यूट को उसी क्रम में दिखाता है जिस क्रम में वे दस्तावेज़ में दिखते हैं.
getChild(name)Elementदिए गए नाम वाला पहला Element नोड और कोई नेमस्पेस नहीं पाता है, जो इस Element नोड का तुरंत बच्चा है.
getChild(name, namespace)Elementदिए गए नाम और नेमस्पेस वाला पहला Element नोड पाता है, जो इस Element नोड का तुरंत बच्चा होता है.
getChildText(name)Stringअगर नोड, Element नोड का डायरेक्ट चाइल्ड है, तो दिए गए नाम और बिना नेमस्पेस वाले नोड की टेक्स्ट वैल्यू पाता है.
getChildText(name, namespace)Stringअगर कोई नोड, Element नोड का सीधा-सही बच्चा है, तो दिए गए नाम और नेमस्पेस वाले नोड की टेक्स्ट वैल्यू दिखाता है.
getChildren()Element[]इस Element नोड के सभी Element नोड को उसी क्रम में पाता है जिसमें वे दस्तावेज़ में दिखते हैं.
getChildren(name)Element[]दिए गए नाम और बिना नेमस्पेस वाले सभी Element नोड पाता है. ये नोड, इस Element नोड के सबसे छोटे चाइल्ड होते हैं. ये नोड, दस्तावेज़ में दिखने के क्रम में मिलते हैं.
getChildren(name, namespace)Element[]दिए गए नाम और नेमस्पेस वाले सभी Element नोड पाता है. ये नोड, इस Element नोड के डायरेक्ट चाइल्ड होते हैं. ये नोड, दस्तावेज़ में दिखने के क्रम में मिलते हैं.
getContent(index)Contentयह दिए गए इंडेक्स पर मौजूद उस नोड को दिखाता है जो {@code Element} नोड के चाइल्ड नोड में शामिल है.
getContentSize()Integer{@code Element} नोड के चाइल्ड नोड की संख्या दिखाता है.
getDescendants()Content[]यह उन सभी नोड को उसी क्रम में दिखाता है जिस क्रम में वे दस्तावेज़ में दिखते हैं. ये नोड, {@code Element} नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड होते हैं.
getDocument()Documentवह एक्सएमएल दस्तावेज़ दिखाता है जिसमें {@code Element} नोड मौजूद है.
getName()StringElement नोड का स्थानीय नाम दिखाता है.
getNamespace()NamespaceElement नोड के लिए नेमस्पेस पाता है.
getNamespace(prefix)NamespaceElement नोड के लिए, दिए गए प्रीफ़िक्स वाला नेमस्पेस पाता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getQualifiedName()StringElement नोड का स्थानीय नाम और नेमस्पेस प्रीफ़िक्स, [namespacePrefix]:[localName] फ़ॉर्मैट में पाता है.
getText()StringElement नोड की टेक्स्ट वैल्यू दिखाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.
isAncestorOf(other)Booleanयह तय करता है कि यह Element नोड, किसी दिए गए Element नोड का सीधा या अप्रत्यक्ष पैरंट है या नहीं.
isRootElement()Booleanयह तय करता है कि Element नोड, दस्तावेज़ का रूट नोड है या नहीं.
removeAttribute(attribute)Booleanअगर इस Element नोड के लिए कोई एट्रिब्यूट मौजूद है, तो उसे हटा देता है.
removeAttribute(attributeName)Booleanअगर इस Element नोड के लिए, दिए गए नाम और बिना नेमस्पेस वाला एट्रिब्यूट मौजूद है, तो उसे हटा देता है.
removeAttribute(attributeName, namespace)Booleanअगर इस Element नोड के लिए, दिए गए नाम और नेमस्पेस वाला एट्रिब्यूट मौजूद है, तो उसे हटा देता है.
removeContent()Content[]{@code Element} नोड के बच्चों वाले सभी नोड हटाता है.
removeContent(content)Booleanअगर दिया गया नोड, {@code Element} नोड का चाइल्ड है, तो उसे हटा देता है.
removeContent(index)Contentयह दिए गए इंडेक्स पर मौजूद नोड को हटा देता है. यह नोड, {@code Element} नोड के बच्चों में से किसी एक होता है.
setAttribute(attribute)Elementइस Element नोड के लिए, दिए गए एट्रिब्यूट को सेट करता है.
setAttribute(name, value)Elementइस Element नोड के लिए, दिए गए नाम, वैल्यू, और बिना नेमस्पेस के एट्रिब्यूट सेट करता है.
setAttribute(name, value, namespace)Elementदिए गए नाम, वैल्यू, और नेमस्पेस के साथ इस Element नोड के लिए एट्रिब्यूट सेट करता है.
setName(name)ElementElement नोड का स्थानीय नाम सेट करता है.
setNamespace(namespace)ElementElement नोड के लिए नेमस्पेस सेट करता है.
setText(text)ElementElement नोड की टेक्स्ट वैल्यू सेट करता है.

EntityRef

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getName()StringEntityReference नोड का नाम दिखाता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getPublicId()StringEntityReference नोड का सार्वजनिक आईडी पाता है.
getSystemId()StringEntityReference नोड का सिस्टम आईडी पाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.
setName(name)EntityRefEntityReference नोड का नाम सेट करता है.
setPublicId(id)EntityRefEntityReference नोड का सार्वजनिक आईडी सेट करता है.
setSystemId(id)EntityRefEntityReference नोड का सिस्टम आईडी सेट करता है.

Format

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
format(document)Stringदिए गए Document को फ़ॉर्मैट की गई स्ट्रिंग के तौर पर दिखाता है.
format(element)Stringदिए गए Element नोड को फ़ॉर्मैट की गई स्ट्रिंग के तौर पर दिखाता है.
setEncoding(encoding)Formatफ़ॉर्मैटर के लिए कैरेक्टर एन्कोडिंग सेट करता है.
setIndent(indent)Formatपैरंट नोड के हिसाब से चाइल्ड नोड को इंडेंट करने के लिए इस्तेमाल की जाने वाली स्ट्रिंग सेट करता है.
setLineSeparator(separator)Formatजब फ़ॉर्मैटर सामान्य रूप से लाइन ब्रेक डालता है, तब डालने के लिए स्ट्रिंग सेट करता है.
setOmitDeclaration(omitDeclaration)Formatइससे यह तय होता है कि फ़ॉर्मैटर को <?xml version="1.0" encoding="UTF-8"?> जैसे एक्सएमएल एलान को हटाना चाहिए या नहीं.
setOmitEncoding(omitEncoding)Formatइससे यह तय होता है कि फ़ॉर्मैटर को एक्सएमएल एलानेशन में एन्कोडिंग को शामिल करना चाहिए या नहीं. जैसे, <?xml version="1.0" encoding="UTF-8"?> में एन्कोडिंग फ़ील्ड.

Namespace

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getPrefix()Stringनेमस्पेस के प्रीफ़िक्स को दिखाता है.
getURI()Stringनेमस्पेस का यूआरआई पाता है.

ProcessingInstruction

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getData()StringProcessingInstruction नोड में मौजूद हर निर्देश के लिए रॉ डेटा पाता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getTarget()StringProcessingInstruction नोड के लिए टारगेट पाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.

Text

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
append(text)Textदिए गए टेक्स्ट को नोड में पहले से मौजूद किसी भी कॉन्टेंट में जोड़ता है.
detach()Contentनोड को उसके पैरंट Element नोड से अलग करता है.
getParentElement()Elementयह फ़ंक्शन, नोड के पैरंट Element नोड को दिखाता है.
getText()StringText नोड की टेक्स्ट वैल्यू दिखाता है.
getValue()Stringयह फ़ंक्शन, दस्तावेज़ में दिखने के क्रम में, नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड नोड की टेक्स्ट वैल्यू दिखाता है.
setText(text)TextText नोड की टेक्स्ट वैल्यू सेट करता है.

XmlService

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
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 बनाता है.