XML Service

Layanan XML

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

Class

Nama	Deskripsi singkat
Attribute	Representasi atribut XML.
Cdata	Representasi node CDATASection XML.
Comment	Representasi node Comment XML.
Content	Representasi node XML generik.
ContentType	Enumerasi yang merepresentasikan jenis node konten XML.
DocType	Representasi node DocumentType XML.
Document	Representasi dokumen XML.
Element	Representasi node Element XML.
EntityRef	Representasi node EntityReference XML.
Format	Formatter untuk menampilkan dokumen XML, dengan tiga format standar yang dapat disesuaikan lebih lanjut.
Namespace	Representasi namespace XML.
ProcessingInstruction	Representasi node ProcessingInstruction XML.
Text	Representasi node Text XML.
XmlService	Layanan ini memungkinkan skrip mengurai, menjelajahi, dan membuat dokumen XML secara terprogram.

Attribute

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getName()	String	Mendapatkan nama lokal atribut.
getNamespace()	Namespace|null	Mendapatkan namespace untuk atribut.
getValue()	String	Mendapatkan nilai atribut.
setName(name)	Attribute	Menetapkan nama lokal atribut.
setNamespace(namespace)	Attribute	Menetapkan namespace untuk atribut.
setValue(value)	Attribute	Menetapkan nilai atribut.

Cdata

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
append(text)	Text	Menambahkan teks tertentu ke konten yang sudah ada di node.
detach()	Content|null	Melepaskan node dari node induk Element.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getText()	String	Mendapatkan nilai teks node Text.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
setText(text)	Text	Menetapkan nilai teks node Text.

Comment

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
detach()	Content|null	Melepaskan node dari node induk Element.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getText()	String	Mendapatkan nilai teks node Comment.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
setText(text)	Comment	Menetapkan nilai teks node Comment.

Content

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
asCdata()	Cdata|null	Mentransmisikan node sebagai node CDATASection untuk tujuan pelengkapan otomatis.
asComment()	Comment|null	Mentransmisikan node sebagai node Comment untuk tujuan pelengkapan otomatis.
asDocType()	DocType|null	Mentransmisikan node sebagai node DocumentType untuk tujuan pelengkapan otomatis.
asElement()	Element|null	Mengirimkan node sebagai node Element untuk tujuan pelengkapan otomatis.
asEntityRef()	EntityRef|null	Mentransmisikan node sebagai node EntityReference untuk tujuan pelengkapan otomatis.
asProcessingInstruction()	ProcessingInstruction|null	Mentransmisikan node sebagai node ProcessingInstruction untuk tujuan pelengkapan otomatis.
asText()	Text|null	Mentransmisikan node sebagai node Text untuk tujuan pelengkapan otomatis.
detach()	Content|null	Melepaskan node dari node induk Element.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getType()	ContentType	Mendapatkan jenis konten node.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.

ContentType

Properti

Properti	Jenis	Deskripsi
CDATA	Enum	Node CDATASection XML.
COMMENT	Enum	Node Comment XML.
DOCTYPE	Enum	Node DocumentType XML.
ELEMENT	Enum	Node Element XML.
ENTITYREF	Enum	Node EntityReference XML.
PROCESSINGINSTRUCTION	Enum	Node ProcessingInstruction XML.
TEXT	Enum	Node Text XML.

DocType

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
detach()	Content|null	Melepaskan node dari node induk Element.
getElementName()	String	Mendapatkan nama node Element root yang ditentukan dalam deklarasi DocType.
getInternalSubset()	String	Mendapatkan data subset internal untuk node DocumentType.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getPublicId()	String	Mendapatkan ID publik data subset eksternal untuk node DocumentType.
getSystemId()	String	Mendapatkan ID sistem data subset eksternal untuk node DocumentType.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
setElementName(name)	DocType	Menetapkan nama node Element root yang akan ditentukan dalam deklarasi DocType.
setInternalSubset(data)	DocType	Menetapkan data subset internal untuk node DocumentType.
setPublicId(id)	DocType	Menetapkan ID publik data subset eksternal untuk node DocumentType.
setSystemId(id)	DocType	Menetapkan ID sistem data subset eksternal untuk node DocumentType.

Document

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
addContent(content)	Document	Menambahkan node yang diberikan ke akhir dokumen.
addContent(index, content)	Document	Menyisipkan node tertentu pada indeks tertentu di antara semua node yang merupakan turunan langsung dari dokumen.
cloneContent()	Content[]	Membuat salinan yang tidak terlampir dari semua node yang merupakan turunan langsung dari dokumen.
detachRootElement()	Element|null	Melepaskan dan menampilkan node Element root dokumen.
getAllContent()	Content[]	Mendapatkan semua node yang merupakan turunan langsung dari dokumen.
getContent(index)	Content|null	Mendapatkan node pada indeks tertentu di antara semua node yang merupakan turunan langsung dari dokumen.
getContentSize()	Integer	Mendapatkan jumlah node yang merupakan turunan langsung dari dokumen.
getDescendants()	Content[]	Mendapatkan semua node yang merupakan turunan langsung atau tidak langsung dari dokumen, dalam urutan yang ditampilkan dalam dokumen.
getDocType()	DocType|null	Mendapatkan pernyataan DocType dokumen.
getRootElement()	Element|null	Mendapatkan node Element root dokumen.
hasRootElement()	Boolean	Menentukan apakah dokumen memiliki node Element root.
removeContent()	Content[]	Menghapus semua node yang merupakan turunan langsung dari dokumen.
removeContent(content)	Boolean	Menghapus node yang diberikan, jika node tersebut adalah turunan langsung dari dokumen.
removeContent(index)	Content|null	Menghapus node pada indeks tertentu di antara semua node yang merupakan turunan langsung dari dokumen.
setDocType(docType)	Document	Menetapkan deklarasi DocType dokumen.
setRootElement(element)	Document	Menetapkan node Element root dokumen.

Element

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
addContent(content)	Element	Menambahkan node yang diberikan sebagai turunan terakhir dari node Element.
addContent(index, content)	Element	Menyisipkan node tertentu pada indeks tertentu di antara semua node yang merupakan turunan langsung dari node Element.
cloneContent()	Content[]	Membuat salinan yang tidak terlampir dari semua node yang merupakan turunan langsung dari node {@code Element}.
detach()	Content|null	Melepaskan node dari node induk Element.
getAllContent()	Content[]	Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}.
getAttribute(name)	Attribute|null	Mendapatkan atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace.
getAttribute(name, namespace)	Attribute|null	Mendapatkan atribut untuk node Element ini dengan nama dan namespace yang diberikan.
getAttributes()	Attribute[]	Mendapatkan semua atribut untuk node Element ini, dalam urutan yang muncul dalam dokumen.
getChild(name)	Element|null	Mendapatkan node Element pertama dengan nama tertentu dan tanpa namespace yang merupakan turunan langsung dari node Element ini.
getChild(name, namespace)	Element|null	Mendapatkan node Element pertama dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini.
getChildText(name)	String|null	Mendapatkan nilai teks node dengan nama tertentu dan tanpa namespace, jika node adalah turunan langsung dari node Element.
getChildText(name, namespace)	String|null	Mendapatkan nilai teks node dengan nama dan namespace tertentu, jika node adalah turunan langsung dari node Element.
getChildren()	Element[]	Mendapatkan semua node Element yang merupakan turunan langsung dari node Element ini, dalam urutan yang muncul dalam dokumen.
getChildren(name)	Element[]	Mendapatkan semua node Element dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element ini, dalam urutan yang muncul dalam dokumen.
getChildren(name, namespace)	Element[]	Mendapatkan semua node Element dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini, dalam urutan yang muncul dalam dokumen.
getContent(index)	Content|null	Mendapatkan node pada indeks tertentu di antara semua node yang merupakan turunan langsung dari node {@code Element}.
getContentSize()	Integer	Mendapatkan jumlah node yang merupakan turunan langsung dari node {@code Element}.
getDescendants()	Content[]	Mendapatkan semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}, dalam urutan yang ditampilkan dalam dokumen.
getDocument()	Document	Mendapatkan dokumen XML yang berisi node {@code Element}.
getName()	String	Mendapatkan nama lokal node Element.
getNamespace()	Namespace	Mendapatkan namespace untuk node Element.
getNamespace(prefix)	Namespace	Mendapatkan namespace dengan awalan yang diberikan untuk node Element.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getQualifiedName()	String	Mendapatkan nama lokal dan awalan namespace node Element, dalam bentuk [namespacePrefix]:[localName].
getText()	String	Mendapatkan nilai teks node Element.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
isAncestorOf(other)	Boolean	Menentukan apakah node Element ini adalah induk langsung atau tidak langsung dari node Element tertentu.
isRootElement()	Boolean	Menentukan apakah node Element adalah node root dokumen.
removeAttribute(attribute)	Boolean	Menghapus atribut tertentu untuk node Element ini, jika atribut tersebut ada.
removeAttribute(attributeName)	Boolean	Menghapus atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace, jika atribut tersebut ada.
removeAttribute(attributeName, namespace)	Boolean	Menghapus atribut untuk node Element ini dengan nama dan namespace yang diberikan, jika atribut tersebut ada.
removeContent()	Content[]	Menghapus semua node yang merupakan turunan langsung dari node {@code Element}.
removeContent(content)	Boolean	Menghapus node yang diberikan, jika node tersebut adalah turunan langsung dari node {@code Element}.
removeContent(index)	Content|null	Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}.
setAttribute(attribute)	Element	Menetapkan atribut yang diberikan untuk node Element ini.
setAttribute(name, value)	Element	Menetapkan atribut untuk node Element ini dengan nama dan nilai yang diberikan, serta tanpa namespace.
setAttribute(name, value, namespace)	Element	Menetapkan atribut untuk node Element ini dengan nama, nilai, dan namespace yang diberikan.
setName(name)	Element	Menetapkan nama lokal node Element.
setNamespace(namespace)	Element	Menetapkan namespace untuk node Element.
setText(text)	Element	Menetapkan nilai teks node Element.

EntityRef

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
detach()	Content|null	Melepaskan node dari node induk Element.
getName()	String	Mendapatkan nama node EntityReference.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getPublicId()	String|null	Mendapatkan ID publik node EntityReference.
getSystemId()	String|null	Mendapatkan ID sistem node EntityReference.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
setName(name)	EntityRef	Menetapkan nama node EntityReference.
setPublicId(id)	EntityRef	Menetapkan ID publik node EntityReference.
setSystemId(id)	EntityRef	Menetapkan ID sistem node EntityReference.

Format

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
format(document)	String	Menampilkan Document yang diberikan sebagai string yang diformat.
format(element)	String	Menampilkan node Element yang diberikan sebagai string yang diformat.
setEncoding(encoding)	Format	Menetapkan encoding karakter yang harus digunakan pemformat.
setIndent(indent)	Format	Menetapkan string yang digunakan untuk mengindentasi node turunan relatif terhadap induknya.
setLineSeparator(separator)	Format	Menetapkan string yang akan disisipkan setiap kali pemformat biasanya menyisipkan jeda baris.
setOmitDeclaration(omitDeclaration)	Format	Menetapkan apakah pemformat harus menghapus deklarasi XML, seperti <?xml version="1.0" encoding="UTF-8"?>.
setOmitEncoding(omitEncoding)	Format	Menetapkan apakah pemformat harus menghilangkan encoding dalam deklarasi XML, seperti kolom encoding di <?xml version="1.0" encoding="UTF-8"?>.

Namespace

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getPrefix()	String	Mendapatkan awalan untuk namespace.
getURI()	String	Mendapatkan URI untuk namespace.

ProcessingInstruction

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
detach()	Content|null	Melepaskan node dari node induk Element.
getData()	String	Mendapatkan data mentah untuk setiap petunjuk di node ProcessingInstruction.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getTarget()	String	Mendapatkan target untuk node ProcessingInstruction.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.

Text

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
append(text)	Text	Menambahkan teks tertentu ke konten yang sudah ada di node.
detach()	Content|null	Melepaskan node dari node induk Element.
getParentElement()	Element|null	Mendapatkan node induk Element node.
getText()	String	Mendapatkan nilai teks node Text.
getValue()	String	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
setText(text)	Text	Menetapkan nilai teks node Text.

XmlService

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.