Class XmlService

XmlService

Layanan ini memungkinkan skrip mengurai, menjelajahi, dan membuat dokumen XML secara terprogram.

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

Properti

Properti	Jenis	Deskripsi
ContentTypes	ContentType	Enumerasi yang merepresentasikan jenis node konten XML.

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
createCdata(text)	Cdata	Membuat node CDATASection yang tidak terlampir dengan nilai yang diberikan.
createComment(text)	Comment	Membuat node Comment yang tidak terlampir dengan nilai yang diberikan.
createDocType(elementName)	DocType	Membuat node DocumentType yang tidak terlampir untuk node Element root dengan nama yang diberikan.
createDocType(elementName, systemId)	DocType	Membuat node DocumentType yang tidak terlampir untuk node Element root dengan nama yang diberikan, dan ID sistem yang diberikan untuk data subset eksternal.
createDocType(elementName, publicId, systemId)	DocType	Membuat node DocumentType yang tidak terlampir untuk node Element root dengan nama yang diberikan, serta ID publik dan ID sistem yang diberikan untuk data subset eksternal.
createDocument()	Document	Membuat dokumen XML kosong.
createDocument(rootElement)	Document	Membuat dokumen XML dengan node Element root yang ditentukan.
createElement(name)	Element	Membuat node Element yang tidak terlampir dengan nama lokal yang diberikan dan tanpa namespace.
createElement(name, namespace)	Element	Membuat node Element yang tidak terlampir dengan nama lokal dan namespace yang ditentukan.
createText(text)	Text	Membuat node Text yang tidak terlampir dengan nilai yang diberikan.
getCompactFormat()	Format	Membuat objek Format untuk menghasilkan dokumen XML ringkas.
getNamespace(uri)	Namespace	Membuat Namespace dengan URI yang ditentukan.
getNamespace(prefix, uri)	Namespace	Membuat Namespace dengan awalan dan URI yang ditentukan.
getNoNamespace()	Namespace	Membuat Namespace yang menunjukkan tidak adanya namespace nyata.
getPrettyFormat()	Format	Membuat objek Format untuk menghasilkan dokumen XML yang dapat dibaca manusia.
getRawFormat()	Format	Membuat objek Format untuk menampilkan dokumen XML mentah.
getXmlNamespace()	Namespace	Membuat Namespace dengan awalan xml standar.
parse(xml)	Document	Membuat Document dari XML yang diberikan, tanpa memvalidasi XML.

Dokumentasi mendetail

createCdata(text)

Membuat node CDATASection yang tidak terlampir dengan nilai yang diberikan.

Parameter

Nama	Jenis	Deskripsi
text	String	Nilai yang akan ditetapkan.

Pulang pergi

Cdata — Node CDATASection yang baru dibuat.

---

createComment(text)

Membuat node Comment yang tidak terlampir dengan nilai yang diberikan.

Parameter

Nama	Jenis	Deskripsi
text	String	Nilai yang akan ditetapkan.

Pulang pergi

Comment — Node Comment yang baru dibuat.

---

createDocType(elementName)

Membuat node DocumentType yang tidak terlampir untuk node Element root dengan nama yang diberikan.

Parameter

Nama	Jenis	Deskripsi
elementName	String	Nama node Element root yang akan ditentukan dalam deklarasi DocType.

Pulang pergi

DocType — Node DocumentType yang baru dibuat.

---

createDocType(elementName, systemId)

Membuat node DocumentType yang tidak terlampir untuk node Element root dengan nama yang diberikan, dan ID sistem yang diberikan untuk data subset eksternal.

Parameter

Nama	Jenis	Deskripsi
elementName	String	Nama node Element root yang akan ditentukan dalam deklarasi DocType.
systemId	String	ID sistem data subset eksternal yang akan ditetapkan.

Pulang pergi

DocType — Node DocumentType yang baru dibuat.

---

createDocType(elementName, publicId, systemId)

Membuat node DocumentType yang tidak terlampir untuk node Element root dengan nama yang diberikan, serta ID publik dan ID sistem yang diberikan untuk data subset eksternal.

Parameter

Nama	Jenis	Deskripsi
elementName	String	Nama node Element root yang akan ditentukan dalam deklarasi DocType.
publicId	String	ID publik data subset eksternal yang akan ditetapkan.
systemId	String	ID sistem data subset eksternal yang akan ditetapkan.

Pulang pergi

DocType — Node DocumentType yang baru dibuat.

---

createDocument()

Membuat dokumen XML kosong.

Pulang pergi

Document — Dokumen yang baru dibuat.

---

createDocument(rootElement)

Membuat dokumen XML dengan node Element root yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
rootElement	Element	Node Element root yang akan ditetapkan.

Pulang pergi

Document — Dokumen yang baru dibuat.

---

createElement(name)

Membuat node Element yang tidak terlampir dengan nama lokal yang diberikan dan tanpa namespace.

Parameter

Nama	Jenis	Deskripsi
name	String	Nama lokal yang akan ditetapkan.

Pulang pergi

Element — Node Element yang baru dibuat.

---

createElement(name, namespace)

Membuat node Element yang tidak terlampir dengan nama lokal dan namespace yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
name	String	Nama lokal yang akan ditetapkan.
namespace	Namespace	Namespace yang akan ditetapkan.

Pulang pergi

Element — Node Element yang baru dibuat.

---

createText(text)

Membuat node Text yang tidak terlampir dengan nilai yang diberikan.

Parameter

Nama	Jenis	Deskripsi
text	String	Nilai yang akan ditetapkan.

Pulang pergi

Text — Node Text yang baru dibuat.

---

getCompactFormat()

Membuat objek Format untuk menghasilkan dokumen XML ringkas. Pemformat secara default menggunakan encoding UTF-8, tanpa indentasi, dan tanpa jeda baris tambahan, tetapi menyertakan deklarasi XML dan encoding-nya.

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

Pulang pergi

Format — Pemformat yang baru dibuat.

---

getNamespace(uri)

Membuat Namespace dengan URI yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
uri	String	URI untuk namespace.

Pulang pergi

Namespace — Namespace yang baru dibuat.

---

getNamespace(prefix, uri)

Membuat Namespace dengan awalan dan URI yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
prefix	String	Awalan untuk namespace.
uri	String	URI untuk namespace.

Pulang pergi

Namespace — Namespace yang baru dibuat.

---

getNoNamespace()

Membuat Namespace yang menunjukkan tidak adanya namespace nyata.

Pulang pergi

Namespace — Namespace yang baru dibuat.

---

getPrettyFormat()

Membuat objek Format untuk menghasilkan dokumen XML yang dapat dibaca manusia. Pemformat secara default menggunakan encoding UTF-8, indentasi dua spasi, pemisah baris \r\n setelah setiap node, dan menyertakan deklarasi XML dan encoding-nya.

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

Pulang pergi

Format — Pemformat yang baru dibuat.

---

getRawFormat()

Membuat objek Format untuk menampilkan dokumen XML mentah. Pemformat secara default menggunakan encoding UTF-8, tanpa indentasi dan tanpa jeda baris selain yang disediakan dalam dokumen XML itu sendiri, serta menyertakan deklarasi XML dan encoding-nya.

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

Pulang pergi

Format — Pemformat yang baru dibuat.

---

getXmlNamespace()

Membuat Namespace dengan awalan xml standar.

Pulang pergi

Namespace — Namespace yang baru dibuat.

---

parse(xml)

Membuat Document dari XML yang diberikan, tanpa memvalidasi XML.

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

Parameter

Nama	Jenis	Deskripsi
xml	String	XML yang akan diuraikan.

Pulang pergi

Document — Dokumen yang baru dibuat.