This service allows scripts to parse, navigate, and programmatically create XML documents.
// 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); }
Properties
Property | Type | Description |
---|---|---|
Content | Content | An enumeration representing the types of XML content nodes. |
Methods
Method | Return type | Brief description |
---|---|---|
create | Cdata | Creates an unattached CDATASection node with the given value. |
create | Comment | Creates an unattached Comment node with the given value. |
create | Doc | Creates an unattached Document node for the root Element node
with the given name. |
create | Doc | Creates an unattached Document node for the root Element node
with the given name, and the given system ID for the external subset data. |
create | Doc | Creates an unattached Document node for the root Element node
with the given name, and the given public ID and system ID for the external subset data. |
create | Document | Creates an empty XML document. |
create | Document | Creates an XML document with the given root Element node. |
create | Element | Creates an unattached Element node with the given local name and no namespace. |
create | Element | Creates an unattached Element node with the given local name and namespace. |
create | Text | Creates an unattached Text node with the given value. |
get | Format | Creates a Format object for outputting a compact XML document. |
get | Namespace | Creates a Namespace with the given URI. |
get | Namespace | Creates a Namespace with the given prefix and URI. |
get | Namespace | Creates a Namespace that represents the absence of a real namespace. |
get | Format | Creates a Format object for outputting a human-readable XML document. |
get | Format | Creates a Format object for outputting a raw XML document. |
get | Namespace | Creates a Namespace with the standard xml prefix. |
parse(xml) | Document | Creates an Document from the given XML, without validating the XML. |
Detailed documentation
createCdata(text)
Creates an unattached CDATASection
node with the given value.
Parameters
Name | Type | Description |
---|---|---|
text | String | the value to set |
Return
Cdata
— the newly created CDATASection
node
createComment(text)
createDocType(elementName)
Creates an unattached Document
node for the root Element
node
with the given name.
Parameters
Name | Type | Description |
---|---|---|
element | String | the name of the root Element node to specify in the Doc
declaration |
Return
Doc
— the newly created Document
node
createDocType(elementName, systemId)
Creates an unattached Document
node for the root Element
node
with the given name, and the given system ID for the external subset data.
Parameters
Name | Type | Description |
---|---|---|
element | String | the name of the root Element node to specify in the Doc
declaration |
system | String | the system ID of the external subset data to set |
Return
Doc
— the newly created Document
node
createDocType(elementName, publicId, systemId)
Creates an unattached Document
node for the root Element
node
with the given name, and the given public ID and system ID for the external subset data.
Parameters
Name | Type | Description |
---|---|---|
element | String | the name of the root Element node to specify in the Doc
declaration |
public | String | the public ID of the external subset data to set |
system | String | the system ID of the external subset data to set |
Return
Doc
— the newly created Document
node
createDocument()
createDocument(rootElement)
createElement(name)
createElement(name, namespace)
createText(text)
getCompactFormat()
Creates a Format
object for outputting a compact XML document. The formatter
defaults to UTF-8
encoding, no indentation, and no additional line breaks, but includes
the XML declaration and its encoding.
// 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);
Return
Format
— the newly created formatter
getNamespace(uri)
getNamespace(prefix, uri)
getNoNamespace()
getPrettyFormat()
Creates a Format
object for outputting a human-readable XML document. The formatter
defaults to UTF-8
encoding, two-space indentation, \r\n
line separators after
every node, and includes the XML declaration and its encoding.
// 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);
Return
Format
— the newly created formatter
getRawFormat()
Creates a Format
object for outputting a raw XML document. The formatter defaults to
UTF-8
encoding, no indentation and no line breaks other than those provided in the XML
document itself, and includes the XML declaration and its encoding.
// 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);
Return
Format
— the newly created formatter