XML Service

Dịch vụ XML

Dịch vụ này cho phép các tập lệnh phân tích cú pháp, điều hướng và tạo tài liệu XML theo chương trình.

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

Lớp

TênMô tả ngắn
AttributeBiểu thị một thuộc tính XML.
CdataBiểu thị một nút CDATASection XML.
CommentBiểu thị một nút Comment XML.
ContentBiểu thị một nút XML chung.
ContentTypeMột kiểu liệt kê biểu thị các loại nút nội dung XML.
DocTypeBiểu thị một nút DocumentType XML.
DocumentMột bản trình bày của tài liệu XML.
ElementBiểu thị một nút Element XML.
EntityRefBiểu thị một nút EntityReference XML.
FormatMột trình định dạng để xuất tài liệu XML, với 3 định dạng được xác định trước mà bạn có thể tuỳ chỉnh thêm.
NamespaceBiểu thị một không gian tên XML.
ProcessingInstructionBiểu thị một nút ProcessingInstruction XML.
TextBiểu thị một nút Text XML.
XmlServiceDịch vụ này cho phép các tập lệnh phân tích cú pháp, điều hướng và tạo tài liệu XML theo cách có lập trình.

Attribute

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getName()StringLấy tên địa phương của thuộc tính.
getNamespace()Namespace|nullLấy không gian tên cho thuộc tính.
getValue()StringLấy giá trị của thuộc tính.
setName(name)AttributeĐặt tên cục bộ cho thuộc tính.
setNamespace(namespace)AttributeĐặt không gian tên cho thuộc tính.
setValue(value)AttributeĐặt giá trị của thuộc tính.

Cdata

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
append(text)TextNối văn bản đã cho vào bất kỳ nội dung nào đã có trong nút.
detach()Content|nullTách nút khỏi nút mẹ Element.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getText()StringLấy giá trị văn bản của nút Text.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.
setText(text)TextĐặt giá trị văn bản của nút Text.

Comment

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
detach()Content|nullTách nút khỏi nút mẹ Element.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getText()StringLấy giá trị văn bản của nút Comment.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.
setText(text)CommentĐặt giá trị văn bản của nút Comment.

Content

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
asCdata()Cdata|nullTruyền nút dưới dạng nút CDATASection cho mục đích tự động hoàn thành.
asComment()Comment|nullTruyền nút dưới dạng nút Comment cho mục đích tự động hoàn thành.
asDocType()DocType|nullTruyền nút dưới dạng nút DocumentType cho mục đích tự động hoàn thành.
asElement()Element|nullTruyền nút dưới dạng nút Element cho mục đích tự động hoàn thành.
asEntityRef()EntityRef|nullTruyền nút dưới dạng nút EntityReference cho mục đích tự động hoàn thành.
asProcessingInstruction()ProcessingInstruction|nullTruyền nút dưới dạng nút ProcessingInstruction cho mục đích tự động hoàn thành.
asText()Text|nullTruyền nút dưới dạng nút Text cho mục đích tự động hoàn thành.
detach()Content|nullTách nút khỏi nút mẹ Element.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getType()ContentTypeLấy loại nội dung của nút.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.

ContentType

Thuộc tính

Thuộc tínhLoạiMô tả
CDATAEnumMột nút CDATASection XML.
COMMENTEnumMột nút Comment XML.
DOCTYPEEnumMột nút DocumentType XML.
ELEMENTEnumMột nút Element XML.
ENTITYREFEnumMột nút EntityReference XML.
PROCESSINGINSTRUCTIONEnumMột nút ProcessingInstruction XML.
TEXTEnumMột nút Text XML.

DocType

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
detach()Content|nullTách nút khỏi nút mẹ Element.
getElementName()StringLấy tên của nút Element gốc được chỉ định trong khai báo DocType.
getInternalSubset()StringLấy dữ liệu tập hợp con nội bộ cho nút DocumentType.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getPublicId()StringLấy mã nhận dạng công khai của dữ liệu tập hợp con bên ngoài cho nút DocumentType.
getSystemId()StringLấy mã nhận dạng hệ thống của dữ liệu tập hợp con bên ngoài cho nút DocumentType.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.
setElementName(name)DocTypeĐặt tên cho nút gốc Element để chỉ định trong khai báo DocType.
setInternalSubset(data)DocTypeĐặt dữ liệu tập hợp con nội bộ cho nút DocumentType.
setPublicId(id)DocTypeĐặt mã nhận dạng công khai của dữ liệu tập hợp con bên ngoài cho nút DocumentType.
setSystemId(id)DocTypeĐặt mã nhận dạng hệ thống của dữ liệu tập hợp con bên ngoài cho nút DocumentType.

Document

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addContent(content)DocumentNối nút đã cho vào cuối tài liệu.
addContent(index, content)DocumentChèn nút đã cho tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của tài liệu.
cloneContent()Content[]Tạo bản sao không đính kèm của tất cả các nút là phần tử con trực tiếp của tài liệu.
detachRootElement()Element|nullTách và trả về nút Element gốc của tài liệu.
getAllContent()Content[]Lấy tất cả các nút là phần tử con trực tiếp của tài liệu.
getContent(index)Content|nullLấy nút tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của tài liệu.
getContentSize()IntegerLấy số lượng nút là phần tử con trực tiếp của tài liệu.
getDescendants()Content[]Lấy tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của tài liệu, theo thứ tự xuất hiện trong tài liệu.
getDocType()DocType|nullLấy khai báo DocType của tài liệu.
getRootElement()Element|nullLấy nút Element gốc của tài liệu.
hasRootElement()BooleanXác định xem tài liệu có nút Element gốc hay không.
removeContent()Content[]Xoá tất cả các nút là phần tử con trực tiếp của tài liệu.
removeContent(content)BooleanXoá nút đã cho, nếu nút đó là phần tử con trực tiếp của tài liệu.
removeContent(index)Content|nullXoá nút tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của tài liệu.
setDocType(docType)DocumentĐặt khai báo DocType của tài liệu.
setRootElement(element)DocumentĐặt nút Element gốc của tài liệu.

Element

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addContent(content)ElementNối nút đã cho làm nút con cuối cùng của nút Element.
addContent(index, content)ElementChèn nút đã cho tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của nút Element.
cloneContent()Content[]Tạo bản sao không đính kèm của tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
detach()Content|nullTách nút khỏi nút mẹ Element.
getAllContent()Content[]Lấy tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
getAttribute(name)Attribute|nullLấy thuộc tính cho nút Element này bằng tên đã cho và không có không gian tên.
getAttribute(name, namespace)Attribute|nullLấy thuộc tính cho nút Element này bằng tên và không gian tên đã cho.
getAttributes()Attribute[]Lấy tất cả các thuộc tính cho nút Element này, theo thứ tự xuất hiện trong tài liệu.
getChild(name)Element|nullLấy nút Element đầu tiên có tên đã cho và không có không gian tên là nút con trực tiếp của nút Element này.
getChild(name, namespace)Element|nullLấy nút Element đầu tiên có tên và không gian tên đã cho là phần tử con trực tiếp của nút Element này.
getChildText(name)String|nullLấy giá trị văn bản của nút có tên cho trước và không có không gian tên, nếu nút đó là một phần tử con trực tiếp của nút Element.
getChildText(name, namespace)String|nullLấy giá trị văn bản của nút có tên và không gian tên đã cho, nếu nút đó là nút con trực tiếp của nút Element.
getChildren()Element[]Lấy tất cả các nút Element là phần tử con trực tiếp của nút Element này, theo thứ tự xuất hiện trong tài liệu.
getChildren(name)Element[]Lấy tất cả các nút Element có tên đã cho và không có không gian tên nào là phần tử con trực tiếp của nút Element này, theo thứ tự xuất hiện trong tài liệu.
getChildren(name, namespace)Element[]Lấy tất cả các nút Element có tên và không gian tên đã cho là phần tử con trực tiếp của nút Element này, theo thứ tự xuất hiện trong tài liệu.
getContent(index)Content|nullLấy nút tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
getContentSize()IntegerLấy số lượng nút là phần tử con trực tiếp của nút {@code Element}.
getDescendants()Content[]Lấy tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút {@code Element}, theo thứ tự xuất hiện trong tài liệu.
getDocument()DocumentLấy tài liệu XML chứa nút {@code Element}.
getName()StringLấy tên cục bộ của nút Element.
getNamespace()NamespaceLấy không gian tên cho nút Element.
getNamespace(prefix)NamespaceLấy vùng chứa tên có tiền tố đã cho cho nút Element.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getQualifiedName()StringLấy tên cục bộ và tiền tố không gian tên của nút Element, ở dạng [namespacePrefix]:[localName].
getText()StringLấy giá trị văn bản của nút Element.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.
isAncestorOf(other)BooleanXác định xem nút Element này có phải là nút mẹ trực tiếp hay gián tiếp của một nút Element nhất định hay không.
isRootElement()BooleanXác định xem nút Element có phải là nút gốc của tài liệu hay không.
removeAttribute(attribute)BooleanXoá thuộc tính đã cho cho nút Element này, nếu có thuộc tính như vậy.
removeAttribute(attributeName)BooleanXoá thuộc tính cho nút Element này bằng tên đã cho và không có không gian tên, nếu thuộc tính đó tồn tại.
removeAttribute(attributeName, namespace)BooleanXoá thuộc tính cho nút Element này bằng tên và không gian tên đã cho, nếu có thuộc tính như vậy.
removeContent()Content[]Xoá tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
removeContent(content)BooleanXoá nút đã cho, nếu nút đó là nút con trực tiếp của nút {@code Element}.
removeContent(index)Content|nullXoá nút tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
setAttribute(attribute)ElementĐặt thuộc tính đã cho cho nút Element này.
setAttribute(name, value)ElementĐặt thuộc tính cho nút Element này bằng tên, giá trị đã cho và không có không gian tên.
setAttribute(name, value, namespace)ElementĐặt thuộc tính cho nút Element này bằng tên, giá trị và không gian tên đã cho.
setName(name)ElementĐặt tên cục bộ cho nút Element.
setNamespace(namespace)ElementĐặt không gian tên cho nút Element.
setText(text)ElementĐặt giá trị văn bản của nút Element.

EntityRef

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
detach()Content|nullTách nút khỏi nút mẹ Element.
getName()StringLấy tên của nút EntityReference.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getPublicId()String|nullLấy mã nhận dạng công khai của nút EntityReference.
getSystemId()String|nullLấy mã nhận dạng hệ thống của nút EntityReference.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.
setName(name)EntityRefĐặt tên cho nút EntityReference.
setPublicId(id)EntityRefĐặt mã nhận dạng công khai của nút EntityReference.
setSystemId(id)EntityRefĐặt mã nhận dạng hệ thống của nút EntityReference.

Format

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
format(document)StringXuất Document đã cho dưới dạng một chuỗi được định dạng.
format(element)StringXuất nút Element đã cho dưới dạng một chuỗi được định dạng.
setEncoding(encoding)FormatĐặt chế độ mã hoá ký tự mà trình định dạng sẽ sử dụng.
setIndent(indent)FormatĐặt chuỗi dùng để thụt lề các nút con so với nút mẹ.
setLineSeparator(separator)FormatĐặt chuỗi cần chèn bất cứ khi nào trình định dạng thường chèn một ký tự ngắt dòng.
setOmitDeclaration(omitDeclaration)FormatĐặt xem trình định dạng có bỏ qua khai báo XML hay không, chẳng hạn như <?xml version="1.0" encoding="UTF-8"?>.
setOmitEncoding(omitEncoding)FormatĐặt xem trình định dạng có bỏ qua việc mã hoá trong khai báo XML hay không, chẳng hạn như trường mã hoá trong <?xml version="1.0" encoding="UTF-8"?>.

Namespace

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getPrefix()StringLấy tiền tố cho vùng chứa tên.
getURI()StringLấy URI cho không gian tên.

ProcessingInstruction

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
detach()Content|nullTách nút khỏi nút mẹ Element.
getData()StringLấy dữ liệu thô cho mọi chỉ dẫn trong nút ProcessingInstruction.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getTarget()StringLấy đích đến cho nút ProcessingInstruction.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.

Text

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
append(text)TextNối văn bản đã cho vào bất kỳ nội dung nào đã có trong nút.
detach()Content|nullTách nút khỏi nút mẹ Element.
getParentElement()Element|nullLấy nút Element mẹ của nút.
getText()StringLấy giá trị văn bản của nút Text.
getValue()StringLấy giá trị văn bản của tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự xuất hiện trong tài liệu.
setText(text)TextĐặt giá trị văn bản của nút Text.

XmlService

Thuộc tính

Thuộc tínhLoạiMô tả
ContentTypesContentTypeMột kiểu liệt kê biểu thị các loại nút nội dung XML.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
createCdata(text)CdataTạo một nút CDATASection chưa được đính kèm với giá trị đã cho.
createComment(text)CommentTạo một nút Comment chưa được đính kèm với giá trị đã cho.
createDocType(elementName)DocTypeTạo một nút DocumentType không được đính kèm cho nút Element gốc bằng tên đã cho.
createDocType(elementName, systemId)DocTypeTạo một nút DocumentType chưa được đính kèm cho nút Element gốc bằng tên đã cho và mã nhận dạng hệ thống đã cho cho dữ liệu tập hợp con bên ngoài.
createDocType(elementName, publicId, systemId)DocTypeTạo một nút DocumentType không được đính kèm cho nút Element gốc có tên đã cho, mã nhận dạng công khai và mã nhận dạng hệ thống đã cho cho dữ liệu tập hợp con bên ngoài.
createDocument()DocumentTạo một tài liệu XML trống.
createDocument(rootElement)DocumentTạo một tài liệu XML có nút gốc Element đã cho.
createElement(name)ElementTạo một nút Element chưa được đính kèm với tên cục bộ đã cho và không có không gian tên.
createElement(name, namespace)ElementTạo một nút Element chưa được đính kèm với tên và không gian tên cục bộ đã cho.
createText(text)TextTạo một nút Text chưa được đính kèm với giá trị đã cho.
getCompactFormat()FormatTạo một đối tượng Format để xuất một tài liệu XML nhỏ gọn.
getNamespace(uri)NamespaceTạo một Namespace bằng URI đã cho.
getNamespace(prefix, uri)NamespaceTạo một Namespace có tiền tố và URI đã cho.
getNoNamespace()NamespaceTạo một Namespace biểu thị sự thiếu vắng không gian tên thực.
getPrettyFormat()FormatTạo một đối tượng Format để xuất tài liệu XML mà người dùng có thể đọc được.
getRawFormat()FormatTạo một đối tượng Format để xuất tài liệu XML thô.
getXmlNamespace()NamespaceTạo một Namespace có tiền tố xml tiêu chuẩn.
parse(xml)DocumentTạo một Document từ tệp XML đã cho mà không xác thực tệp XML đó.