Trang này được dịch bởi Cloud Translation API.

Class 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

Thuộc tính	Loại	Mô tả
`ContentTypes`	`ContentType`	Một bản liệt kê đại diện cho các loại nút nội dung XML.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`createCdata(text)`	`Cdata`	Tạo một nút `CDATASection` chưa được đính kèm có giá trị đã cho.
`createComment(text)`	`Comment`	Tạo một nút `Comment` chưa được đính kèm có giá trị đã cho.
`createDocType(elementName)`	`DocType`	Tạo một nút `DocumentType` chưa được đính kèm cho nút `Element` gốc với tên được đặt.
`createDocType(elementName, systemId)`	`DocType`	Tạo một nút `DocumentType` chưa được đính kèm cho nút `Element` gốc với tên cho sẵn và mã hệ thống đã cho cho dữ liệu tập hợp con bên ngoài.
`createDocType(elementName, publicId, systemId)`	`DocType`	Tạo một nút `DocumentType` chưa được đính kèm cho nút `Element` gốc với tên đã cho, cũng như mã nhận dạng công khai và mã hệ thống đã cho cho dữ liệu tập hợp con bên ngoài.
`createDocument()`	`Document`	Tạo tài liệu XML trống.
`createDocument(rootElement)`	`Document`	Tạo tài liệu XML có nút `Element` gốc đã cho.
`createElement(name)`	`Element`	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.
`createElement(name, namespace)`	`Element`	Tạo một nút `Element` chưa được đính kèm có tên và không gian tên cục bộ đã cho.
`createText(text)`	`Text`	Tạo một nút `Text` chưa được đính kèm có giá trị đã cho.
`getCompactFormat()`	`Format`	Tạo một đối tượng `Format` để xuất tài liệu XML nhỏ gọn.
`getNamespace(uri)`	`Namespace`	Tạo `Namespace` bằng URI nhất định.
`getNamespace(prefix, uri)`	`Namespace`	Tạo `Namespace` bằng tiền tố và URI đã cho.
`getNoNamespace()`	`Namespace`	Tạo `Namespace` đại diện cho trường hợp không có không gian tên thực.
`getPrettyFormat()`	`Format`	Tạo một đối tượng `Format` để xuất tài liệu XML mà con người có thể đọc được.
`getRawFormat()`	`Format`	Tạo một đối tượng `Format` để xuất tài liệu XML thô.
`getXmlNamespace()`	`Namespace`	Tạo `Namespace` bằng tiền tố `xml` chuẩn.
`parse(xml)`	`Document`	Tạo một `Document` từ XML đã cho mà không 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 có giá trị đã cho.

Tham số

Tên	Loại	Mô tả
`text`	`String`	giá trị cần đặt

Cầu thủ trả bóng

Cdata – nút CDATASection mới tạo

`createComment(text)`

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	giá trị cần đặt

Cầu thủ trả bóng

Comment – nút Comment mới tạo

`createDocType(elementName)`

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

Tham số

Tên	Loại	Mô tả
`elementName`	`String`	tên của nút `Element` gốc cần chỉ định trong `DocType` khai báo

Cầu thủ trả bóng

DocType – nút DocumentType mới 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 sẵn và mã hệ thống đã cho cho dữ liệu tập hợp con bên ngoài.

Tham số

Tên	Loại	Mô tả
`elementName`	`String`	tên của nút `Element` gốc cần chỉ định trong `DocType` khai báo
`systemId`	`String`	mã 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 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, cũng như mã nhận dạng công khai và mã hệ thống đã cho cho dữ liệu tập hợp con bên ngoài.

Tham số

Tên	Loại	Mô tả
`elementName`	`String`	tên của nút `Element` gốc cần chỉ định trong `DocType` khai báo
`publicId`	`String`	mã công khai của tập dữ liệu con bên ngoài cần đặt
`systemId`	`String`	mã 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 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 được tạo

`createDocument(rootElement)`

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

Tham số

Tên	Loại	Mô tả
`rootElement`	`Element`	nút `Element` gốc để đặt

Cầu thủ trả bóng

Document — tài liệu mới được 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.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên cục bộ để đặt

Cầu thủ trả bóng

Element – nút Element mới tạo

`createElement(name, namespace)`

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

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên cục bộ để đặt
`namespace`	`Namespace`	không gian tên cần đặt

Cầu thủ trả bóng

Element – nút Element mới tạo

`createText(text)`

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	giá trị cần đặt

Cầu thủ trả bóng

Text – nút Text mới tạo

`getCompactFormat()`

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

// 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 bằng URI nhất định.

Tham số

Tên	Loại	Mô tả
`uri`	`String`	URI 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 Namespace bằng tiền tố và URI đã cho.

Tham số

Tên	Loại	Mô tả
`prefix`	`String`	tiền tố cho không gian tên
`uri`	`String`	URI 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 Namespace đại diện cho trường hợp 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 mặc định là mã hoá UTF-8, thụt lề hai dấu cách, \r\n dòng phân cách sau mỗi nút và bao gồm phần khai báo XML và mã hoá của nó.

// 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 một đố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 ngoài các mã được cung cấp trong XML tài liệu và bao gồm khai báo XML và mã hoá của nó.

// 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 bằng tiền tố xml chuẩn.

Cầu thủ trả bóng

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

`parse(xml)`

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

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

Tham số

Tên	Loại	Mô tả
`xml`	`String`	XML để phân tích cú pháp

Cầu thủ trả bóng

Document — tài liệu mới được tạo