Class XmlService

XmlService

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 phương thức lập trình.

// Log the title and labels for the first page of blog posts on the
// Google Workspace Developer blog.
function parseXml() {
  var url = 'https://gsuite-developers.googleblog.com/atom.xml';
  var xml = UrlFetchApp.fetch(url).getContentText();
  var document = XmlService.parse(xml);
  var root = document.getRootElement();
  var atom = XmlService.getNamespace('http://www.w3.org/2005/Atom');

  var entries = root.getChildren('entry', atom);
  for (var i = 0; i < entries.length; i++) {
    var title = entries[i].getChild('title', atom).getText();
    var categoryElements = entries[i].getChildren('category', atom);
    var labels = [];
    for (var 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() {
  var root = XmlService.createElement('threads');
  var threads = GmailApp.getInboxThreads();
  for (var i = 0; i < threads.length; i++) {
    var child = XmlService.createElement('thread')
        .setAttribute('messageCount', threads[i].getMessageCount())
        .setAttribute('isUnread', threads[i].isUnread())
        .setText(threads[i].getFirstMessageSubject());
    root.addContent(child);
  }
  var document = XmlService.createDocument(root);
  var xml = XmlService.getPrettyFormat().format(document);
  Logger.log(xml);
}

Thuộc tính

Tài sảnLoạiNội dung mô tả
ContentTypesContentTypeMột bảng liệt kê đại diện cho 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 chưa được đính kèm cho nút Element gốc có 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 với tên đã cho và mã hệ thống đã cung cấp cho dữ liệu tập hợp con bên ngoài.
createDocType(elementName, publicId, systemId)DocTypeTạo một nút DocumentType chưa được đính kèm cho nút Element gốc với tên đã cho, và mã nhận dạng công khai và mã nhận dạng hệ thống đã cung cấp cho dữ liệu tập hợp con bên ngoài.
createDocument()DocumentTạo tài liệu XML trống.
createDocument(rootElement)DocumentTạo tài liệu XML bằng nút Element gốc đã cho.
createElement(name)ElementTạo một nút Element chưa được đính kèm có 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 cục bộ và không gian tên đã cho.
createText(text)TextTạo một nút Text chưa được đính kèm với giá trị đã cho.
getCompactFormat()FormatTạo đối tượng Format để xuất một tài liệu XML thu gọn.
getNamespace(uri)NamespaceTạo Namespace với URI đã cho.
getNamespace(prefix, uri)NamespaceTạo một Namespace với tiền tố và URI đã cho.
getNoNamespace()NamespaceTạo một Namespace đại diện cho việc không có không gian tên thực.
getPrettyFormat()FormatTạo đối tượng Format để xuất tài liệu XML mà con người có thể đọc được.
getRawFormat()FormatTạo đối tượng Format để xuất tài liệu XML thô.
getXmlNamespace()NamespaceTạo Namespace với tiền tố xml tiêu chuẩn.
parse(xml)DocumentTạo Document từ XML đã cho mà không cần xác thực XML.

Tài liệu chi tiết

createCdata(text)

Tạo một nút CDATASection chưa được đính kèm với giá trị đã cho.

Các tham số

TênLoạiNội dung mô tả
textStringgiá trị cần đặt

Cầu thủ trả bóng

Cdata – nút CDATASection mới được tạo


createComment(text)

Tạo một nút Comment chưa được đính kèm với giá trị đã cho.

Các tham số

TênLoạiNội dung mô tả
textStringgiá trị cần đặt

Cầu thủ trả bóng

Comment – nút Comment mới được tạo


createDocType(elementName)

Tạo một nút DocumentType chưa được đính kèm cho nút Element gốc có tên đã cho.

Các tham số

TênLoạiNội dung mô tả
elementNameStringtên của nút Element gốc cần chỉ định trong phần khai báo DocType

Cầu thủ trả bóng

DocType – nút DocumentType mới được tạo


createDocType(elementName, systemId)

Tạo một nút DocumentType chưa được đính kèm cho nút Element gốc với tên đã cho và mã hệ thống đã cung cấp cho dữ liệu tập hợp con bên ngoài.

Các tham số

TênLoạiNội dung mô tả
elementNameStringtên của nút Element gốc cần chỉ định trong phần khai báo DocType
systemIdStringmã hệ thống của tập dữ liệu con bên ngoài cần đặt

Cầu thủ trả bóng

DocType – nút DocumentType mới được tạo


createDocType(elementName, publicId, systemId)

Tạo một nút DocumentType chưa được đính kèm cho nút Element gốc với tên đã cho, và mã nhận dạng công khai và mã nhận dạng hệ thống đã cung cấp cho dữ liệu tập hợp con bên ngoài.

Các tham số

TênLoạiNội dung mô tả
elementNameStringtên của nút Element gốc cần chỉ định trong phần khai báo DocType
publicIdStringmã công khai của tập dữ liệu con bên ngoài cần đặt
systemIdStringmã hệ thống của tập dữ liệu con bên ngoài cần đặt

Cầu thủ trả bóng

DocType – nút DocumentType mới được tạo


createDocument()

Tạo tài liệu XML trống.

Cầu thủ trả bóng

Document – tài liệu mới tạo


createDocument(rootElement)

Tạo tài liệu XML bằng nút Element gốc đã cho.

Các tham số

TênLoạiNội dung mô tả
rootElementElementnút Element gốc cần đặt

Cầu thủ trả bóng

Document – tài liệu mới tạo


createElement(name)

Tạo một nút Element chưa được đính kèm có tên cục bộ đã cho và không có không gian tên.

Các tham số

TênLoạiNội dung mô tả
nameStringtên cục bộ cần đặt

Cầu thủ trả bóng

Element – nút Element mới được tạo


createElement(name, namespace)

Tạo một nút Element chưa được đính kèm với tên cục bộ và không gian tên đã cho.

Các tham số

TênLoạiNội dung mô tả
nameStringtên cục bộ cần đặt
namespaceNamespacekhông gian tên cần đặt

Cầu thủ trả bóng

Element – nút Element mới được tạo


createText(text)

Tạo một nút Text chưa được đính kèm với giá trị đã cho.

Các tham số

TênLoạiNội dung mô tả
textStringgiá trị cần đặt

Cầu thủ trả bóng

Text – nút Text mới được tạo


getCompactFormat()

Tạo đối tượng Format để xuất một tài liệu XML thu gọn. Trình định dạng mặc định ở chế độ mã hoá UTF-8, không thụt lề và không ngắt dòng bổ sung, nhưng bao gồm nội dung khai báo XML và phương thức mã hoá.

// Log an XML document in compact form.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getCompactFormat()
    .format(document);
Logger.log(output);

Cầu thủ trả bóng

Format – trình định dạng mới được tạo


getNamespace(uri)

Tạo Namespace với URI đã cho.

Các tham số

TênLoạiNội dung mô tả
uriStringURI cho không gian tên

Cầu thủ trả bóng

Namespace – không gian tên mới tạo


getNamespace(prefix, uri)

Tạo một Namespace với tiền tố và URI đã cho.

Các tham số

TênLoạiNội dung mô tả
prefixStringtiền tố của không gian tên
uriStringURI cho không gian tên

Cầu thủ trả bóng

Namespace – không gian tên mới tạo


getNoNamespace()

Tạo một Namespace đại diện cho việc không có không gian tên thực.

Cầu thủ trả bóng

Namespace – không gian tên mới tạo


getPrettyFormat()

Tạo đối tượng Format để xuất tài liệu XML mà con người có thể đọc được. Trình định dạng được đặt mặc định ở chế độ mã hoá UTF-8, thụt lề hai dấu cách, phân tách dòng \r\n sau mỗi nút, đồng thời bao gồm phần khai báo XML cũng như phương thức mã hoá.

// Log an XML document in human-readable form.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getPrettyFormat()
    .format(document);
Logger.log(output);

Cầu thủ trả bóng

Format – trình định dạng mới được tạo


getRawFormat()

Tạo đối tượng Format để xuất tài liệu XML thô. Trình định dạng mặc định là mã hoá UTF-8, không thụt lề và không ngắt dòng nào ngoài những dòng được cung cấp trong tài liệu XML, đồng thời bao gồm phần khai báo XML và phương thức mã hoá.

// Log an XML document in raw form.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getRawFormat()
    .format(document);
Logger.log(output);

Cầu thủ trả bóng

Format – trình định dạng mới được tạo


getXmlNamespace()

Tạo Namespace với tiền tố xml tiêu chuẩn.

Cầu thủ trả bóng

Namespace – không gian tên mới tạo


parse(xml)

Tạo Document từ XML đã cho mà không cần xác thực XML.

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

Các tham số

TênLoạiNội dung mô tả
xmlStringXML để phân tích cú pháp

Cầu thủ trả bóng

Document – tài liệu mới tạo