Dịch vụ này cho phép phân tích cú pháp, điều hướng và tạo các tập lệnh theo phương thức lập trình Tài liệu XML.
// 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ên | Mô tả ngắn |
---|---|
Attribute | Hình minh hoạ một thuộc tính XML. |
Cdata | Hình minh hoạ một nút CDATASection XML. |
Comment | Hình minh hoạ một nút Comment XML. |
Content | Hình minh hoạ một nút XML chung. |
ContentType | Một bản liệt kê đại diện cho các loại nút nội dung XML. |
DocType | Hình minh hoạ một nút DocumentType XML. |
Document | Bản trình bày một tài liệu XML. |
Element | Hình minh hoạ một nút Element XML. |
EntityRef | Hình minh hoạ một nút EntityReference XML. |
Format | Mộ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 có thể đã được tuỳ chỉnh. |
Namespace | Hình ảnh đại diện cho một không gian tên XML. |
ProcessingInstruction | Hình minh hoạ một nút ProcessingInstruction XML. |
Text | Hình minh hoạ một nút Text XML. |
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. |
Attribute
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
getName() | String | Lấy tên cục bộ của thuộc tính. |
getNamespace() | Namespace | Lấy không gian tên cho thuộc tính. |
getValue() | String | Lấ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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
append(text) | Text | Thêm văn bản đã cho vào bất kỳ nội dung nào đã tồn tại trong nút. |
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getText() | String | Lấy giá trị văn bản của nút Text . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ 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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getText() | String | Lấy giá trị văn bản của nút Comment . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ 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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
asCdata() | Cdata | Truyền nút này dưới dạng một nút CDATASection cho mục đích tự động hoàn thành. |
asComment() | Comment | Truyền nút này dưới dạng một nút Comment cho mục đích tự động hoàn thành. |
asDocType() | DocType | Truyền nút này dưới dạng một nút DocumentType cho mục đích tự động hoàn thành. |
asElement() | Element | Truyền nút này dưới dạng một nút Element cho mục đích tự động hoàn thành. |
asEntityRef() | EntityRef | Truyền nút này dưới dạng một nút EntityReference cho mục đích tự động hoàn thành. |
asProcessingInstruction() | ProcessingInstruction | Truyền nút này dưới dạng một nút ProcessingInstruction cho mục đích tự động hoàn thành. |
asText() | Text | Truyền nút này dưới dạng một nút Text cho mục đích tự động hoàn thành. |
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getType() | ContentType | Lấy loại nội dung của nút. |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ xuất hiện trong tài liệu. |
ContentType
Thuộc tính
Thuộc tính | Loại | Mô tả |
---|---|---|
CDATA | Enum | Nút CDATASection XML. |
COMMENT | Enum | Nút Comment XML. |
DOCTYPE | Enum | Nút DocumentType XML. |
ELEMENT | Enum | Nút Element XML. |
ENTITYREF | Enum | Nút EntityReference XML. |
PROCESSINGINSTRUCTION | Enum | Nút ProcessingInstruction XML. |
TEXT | Enum | Nút Text XML. |
DocType
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getElementName() | String | Lấy tên của nút Element gốc được chỉ định trong phần khai báo DocType . |
getInternalSubset() | String | Lấy dữ liệu tập hợp con nội bộ cho nút DocumentType . |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getPublicId() | String | Lấy mã nhận dạng công khai của dữ liệu tập con bên ngoài cho nút DocumentType . |
getSystemId() | String | Lấy mã hệ thống của dữ liệu tập con bên ngoài cho nút DocumentType . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ xuất hiện trong tài liệu. |
setElementName(name) | DocType | Đặt tên cho nút Element gốc để chỉ định trong DocType
khai báo. |
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ã 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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
addContent(content) | Document | Thêm nút đã cho vào cuối tài liệu. |
addContent(index, content) | Document | Chèn nút đã cho tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của tài liệu. |
cloneContent() | Content[] | Tạo bản sao chưa được đính kèm của tất cả các nút là nút con trực tiếp của tài liệu. |
detachRootElement() | Element | Tá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 | Lấy nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của tài liệu. |
getContentSize() | Integer | Lấy số lượng nút là 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ự sẽ xuất hiện trong tài liệu. |
getDocType() | DocType | Lấy nội dung khai báo DocType của tài liệu. |
getRootElement() | Element | Lấy nút Element gốc của tài liệu. |
hasRootElement() | Boolean | Xác định xem tài liệu có nút Element gốc hay không. |
removeContent() | Content[] | Xóa tất cả các nút là nút con trực tiếp của tài liệu. |
removeContent(content) | Boolean | Xoá nút đã cho, nếu nút đó là nút con trực tiếp của tài liệu. |
removeContent(index) | Content | Xoá nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của tài liệu. |
setDocType(docType) | Document | Thiết lập phần 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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
addContent(content) | Element | Thêm nút đã cho làm nút con cuối cùng của nút Element . |
addContent(index, content) | Element | Chèn nút đã cho tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của
Nút Element . |
cloneContent() | Content[] | Tạo bản sao chưa được đính kèm của tất cả các nút là con trực tiếp của nút {@code Element}. |
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getAllContent() | Content[] | Lấy tất cả các nút là con trực tiếp của nút {@code Element}. |
getAttribute(name) | Attribute | Lấy thuộc tính của nút Element này kèm theo tên đã cho và không có vùng chứa tên. |
getAttribute(name, namespace) | Attribute | Lấy thuộc tính của nút Element này cùng với tên và không gian tên đã cho. |
getAttributes() | Attribute[] | Lấy tất cả thuộc tính của nút Element này theo thứ tự xuất hiện trong tài liệu. |
getChild(name) | Element | Lấy nút Element đầu tiên có tên đã cho và không có vùng chứa tên nào là ngay lập tức
phần tử con của nút Element này. |
getChild(name, namespace) | Element | Lấy nút Element đầu tiên có tên và không gian tên đã cho
phần tử con của nút Element này. |
getChildText(name) | String | Lấy giá trị văn bản của nút có tên đã cho 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 | Lấ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 tức thì
phần tử con của nút Element . |
getChildren() | Element[] | Lấy tất cả các nút Element là nút con trực tiếp của nút Element này, trong
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ó vùng chứa 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 | Lấy nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút {@code Element}. |
getContentSize() | Integer | Lấy số lượng nút là 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ự chúng sẽ xuất hiện trong tài liệu. |
getDocument() | Document | Lấy tài liệu XML chứa nút {@code Element}. |
getName() | String | Lấy tên cục bộ của nút Element . |
getNamespace() | Namespace | Lấy không gian tên cho nút Element . |
getNamespace(prefix) | Namespace | Lấy không gian tên có tiền tố đã cho cho nút Element . |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getQualifiedName() | String | Lấy tên cục bộ và tiền tố không gian tên của nút Element , có dạng [namespacePrefix]:[localName] . |
getText() | String | Lấy giá trị văn bản của nút Element . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ xuất hiện trong tài liệu. |
isAncestorOf(other) | Boolean | Xác định xem nút Element này là nút mẹ trực tiếp hay gián tiếp của một nút Element nhất định. |
isRootElement() | Boolean | Xá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) | Boolean | Xoá thuộc tính đã cho cho nút Element này nếu có thuộc tính như vậy. |
removeAttribute(attributeName) | Boolean | Xoá thuộc tính có tên đã cho và không có vùng chứa tên của nút Element này, nếu
có thuộc tính như vậy. |
removeAttribute(attributeName, namespace) | Boolean | Xoá thuộc tính của nút Element này cùng với tên và không gian tên đã cho, nếu đúng
thuộc tính tồn tại. |
removeContent() | Content[] | Xóa tất cả các nút là con trực tiếp của nút {@code Element}. |
removeContent(content) | Boolean | Xóa nút đã cho, nếu nút này là phần tử con trực tiếp của nút {@code Element}. |
removeContent(index) | Content | Xoá nút tại chỉ mục đã cho trong số tất cả các nút là 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ó vùng chứa 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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getName() | String | Lấy tên của nút EntityReference . |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getPublicId() | String | Lấy mã nhận dạng công khai của nút EntityReference . |
getSystemId() | String | Lấy mã nhận dạng hệ thống của nút EntityReference . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ 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 cho nút EntityReference . |
Format
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
format(document) | String | Cho Document đã cho dưới dạng một chuỗi được định dạng. |
format(element) | String | Xuất nút Element đã cho dưới dạng một chuỗi được định dạng. |
setEncoding(encoding) | Format | Đặt phương thức mã hoá ký tự mà trình định dạng nên sử dụng. |
setIndent(indent) | Format | Đặt chuỗi dùng để thụt lề các nút con tương ứng 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 dấu ngắt dòng. |
setOmitDeclaration(omitDeclaration) | Format | Thiết lập xem trình định dạng có nên bỏ qua phần khai báo XML hay không, chẳng hạn như <?xml version="1.0"
encoding="UTF-8"?> . |
setOmitEncoding(omitEncoding) | Format | Thiết lập xem trình định dạng có nên bỏ qua phần mã hoá trong khai báo XML hay không, chẳng hạn như
trong <?xml version="1.0" encoding="UTF-8"?> . |
Namespace
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
getPrefix() | String | Lấy tiền tố cho không gian tên. |
getURI() | String | Lấy URI cho không gian tên. |
ProcessingInstruction
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getData() | String | Lấy dữ liệu thô cho mỗi lệnh trong nút ProcessingInstruction . |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getTarget() | String | Lấy mục tiêu cho nút ProcessingInstruction . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ xuất hiện trong tài liệu. |
Text
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
append(text) | Text | Thêm văn bản đã cho vào bất kỳ nội dung nào đã tồn tại trong nút. |
detach() | Content | Tách nút này khỏi nút Element mẹ. |
getParentElement() | Element | Lấy nút Element mẹ của nút này. |
getText() | String | Lấy giá trị văn bản của nút Text . |
getValue() | String | Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ 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í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 đố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. |