Bu hizmet, komut dosyalarının XML dokümanlarını ayrıştırmasına, gezinmesine ve programatik olarak oluşturmasına olanak tanır.
// 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); }
Sınıflar
Ad | Kısa açıklama |
---|---|
Attribute | Bir XML özelliğinin gösterimi. |
Cdata | XML CDATASection düğümünü temsil eder. |
Comment | XML Comment düğümünü temsil eder. |
Content | Genel bir XML düğümünü temsil eder. |
ContentType | XML içerik düğümü türlerini temsil eden bir numaralandırma. |
DocType | XML DocumentType düğümünü temsil eder. |
Document | Bir XML belgesinin temsili. |
Element | XML Element düğümünü temsil eder. |
EntityRef | XML EntityReference düğümünü temsil eder. |
Format | Daha fazla özelleştirilebilen önceden tanımlanmış üç biçime sahip XML belgesi çıkışı için bir biçimlendirici. |
Namespace | Bir XML ad alanını temsil eder. |
ProcessingInstruction | XML ProcessingInstruction düğümünü temsil eder. |
Text | XML Text düğümünü temsil eder. |
XmlService | Bu hizmet, komut dosyalarının XML dokümanlarını ayrıştırmasına, gezinmesine ve programlı olarak oluşturmasına olanak tanır. |
Attribute
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getName() | String | Özelliğin yerel adını alır. |
getNamespace() | Namespace | Özelliğin ad alanını alır. |
getValue() | String | Özelliğin değerini alır. |
setName(name) | Attribute | Özelliğin yerel adını ayarlar. |
setNamespace(namespace) | Attribute | Özelliğin ad alanını ayarlar. |
setValue(value) | Attribute | Özelliğin değerini ayarlar. |
Cdata
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
append(text) | Text | Belirtilen metni, düğümde mevcut olan herhangi bir içeriğe ekler. |
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getText() | String | Text düğümünün metin değerini alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
setText(text) | Text | Text düğümünün metin değerini ayarlar. |
Comment
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getText() | String | Comment düğümünün metin değerini alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
setText(text) | Comment | Comment düğümünün metin değerini ayarlar. |
Content
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
asCdata() | Cdata | Düğümü, otomatik tamamlama amacıyla bir CDATASection düğümü olarak yayınlar. |
asComment() | Comment | Düğümü, otomatik tamamlama amacıyla bir Comment düğümü olarak yayınlar. |
asDocType() | DocType | Düğümü, otomatik tamamlama amacıyla bir DocumentType düğümü olarak yayınlar. |
asElement() | Element | Düğümü, otomatik tamamlama amacıyla bir Element düğümü olarak yayınlar. |
asEntityRef() | EntityRef | Düğümü, otomatik tamamlama amacıyla bir EntityReference düğümü olarak yayınlar. |
asProcessingInstruction() | ProcessingInstruction | Düğümü, otomatik tamamlama amacıyla bir ProcessingInstruction düğümü olarak yayınlar. |
asText() | Text | Düğümü, otomatik tamamlama amacıyla bir Text düğümü olarak yayınlar. |
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getType() | ContentType | Düğümün içerik türünü alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
ContentType
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
CDATA | Enum | Bir XML CDATASection düğümü. |
COMMENT | Enum | Bir XML Comment düğümü. |
DOCTYPE | Enum | Bir XML DocumentType düğümü. |
ELEMENT | Enum | Bir XML Element düğümü. |
ENTITYREF | Enum | Bir XML EntityReference düğümü. |
PROCESSINGINSTRUCTION | Enum | Bir XML ProcessingInstruction düğümü. |
TEXT | Enum | Bir XML Text düğümü. |
DocType
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getElementName() | String | DocType bildiriminde belirtilen kök Element düğümünün adını alır. |
getInternalSubset() | String | DocumentType düğümü için dahili alt küme verilerini alır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getPublicId() | String | DocumentType düğümü için harici alt küme verilerinin genel kimliğini alır. |
getSystemId() | String | DocumentType düğümü için harici alt küme verilerinin sistem kimliğini alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
setElementName(name) | DocType | DocType bildiriminde belirtilecek kök Element düğümünün adını ayarlar. |
setInternalSubset(data) | DocType | DocumentType düğümü için dahili alt küme verilerini ayarlar. |
setPublicId(id) | DocType | DocumentType düğümü için harici alt küme verilerinin genel kimliğini ayarlar. |
setSystemId(id) | DocType | DocumentType düğümü için harici alt küme verilerinin sistem kimliğini ayarlar. |
Document
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addContent(content) | Document | Belirtilen düğümü dokümanın sonuna ekler. |
addContent(index, content) | Document | Belirtilen düğümü, dokümanın doğrudan alt öğesi olan tüm düğümler arasında belirtilen dizine ekler. |
cloneContent() | Content[] | Belgenin doğrudan alt öğeleri olan tüm düğümlerin eklenmemiş kopyalarını oluşturur. |
detachRootElement() | Element | Belgenin kök Element düğümünü ayırır ve döndürür. |
getAllContent() | Content[] | Belgenin doğrudan alt öğeleri olan tüm düğümleri alır. |
getContent(index) | Content | Belgenin doğrudan alt öğesi olan tüm düğümler arasında belirtilen dizindeki düğümü alır. |
getContentSize() | Integer | Belgenin hemen alt öğeleri olan düğümlerin sayısını alır. |
getDescendants() | Content[] | Belgenin doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, dokümanda göründükleri sırayla alır. |
getDocType() | DocType | Belgenin DocType bildirimini alır. |
getRootElement() | Element | Belgenin kök Element düğümünü alır. |
hasRootElement() | Boolean | Dokümanın kök Element düğümü olup olmadığını belirler. |
removeContent() | Content[] | Belgenin doğrudan alt öğeleri olan tüm düğümleri kaldırır. |
removeContent(content) | Boolean | Düğüm, dokümanın doğrudan alt öğesiyse belirtilen düğümü kaldırır. |
removeContent(index) | Content | Belirtilen dizindeki düğümü, dokümanın doğrudan alt öğesi olan tüm düğümler arasından kaldırır. |
setDocType(docType) | Document | Dokümanın DocType bildirimini ayarlar. |
setRootElement(element) | Document | Dokümanın kök Element düğümünü ayarlar. |
Element
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addContent(content) | Element | Belirtilen düğümü, Element düğümünün son alt öğesi olarak ekler. |
addContent(index, content) | Element | Belirtilen düğümü, Element düğümünün hemen alt öğesi olan tüm düğümler arasında belirtilen dizine ekler. |
cloneContent() | Content[] | {@code Element} düğümünün hemen alt öğeleri olan tüm düğümlerin eklenmemiş kopyalarını oluşturur. |
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getAllContent() | Content[] | {@code Element} düğümünün hemen alt öğesi olan tüm düğümleri alır. |
getAttribute(name) | Attribute | Bu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan alır. |
getAttribute(name, namespace) | Attribute | Belirtilen ad ve ad alanına sahip bu Element düğümünün özelliğini alır. |
getAttributes() | Attribute[] | Bu Element düğümünün tüm özelliklerini, dokümanda göründükleri sırayla alır. |
getChild(name) | Element | Belirtilen ada sahip ilk Element düğümünü alır ve bu Element düğümünün hemen alt öğesi olmayan ad alanı içermez. |
getChild(name, namespace) | Element | Belirtilen ada ve ad alanına sahip, bu Element düğümünün hemen alt öğesi olan ilk Element düğümünü alır. |
getChildText(name) | String | Düğüm, Element düğümünün doğrudan alt öğesiyse belirtilen ada sahip ve ad alanı olmadan düğümün metin değerini alır. |
getChildText(name, namespace) | String | Düğüm, Element düğümünün en üst düzeylerinden biriyse belirtilen ada ve ad alanına sahip düğümün metin değerini alır. |
getChildren() | Element[] | Bu Element düğümünün hemen alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır. |
getChildren(name) | Element[] | Belirtilen ada sahip olan ve bu Element düğümünün hemen alt öğesi olmayan ad alanı olmayan tüm Element düğümlerini belgede göründükleri sırayla alır. |
getChildren(name, namespace) | Element[] | Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün hemen alt öğeleri olan tüm Element düğümlerini belgede göründükleri sırayla alır. |
getContent(index) | Content | {@code Element} düğümünün hemen alt öğesi olan tüm düğümler arasında belirtilen dizindeki düğümü alır. |
getContentSize() | Integer | {@code Element} düğümünün hemen alt öğesi olan düğümlerin sayısını alır. |
getDescendants() | Content[] | {@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, dokümanda göründükleri sırayla alır. |
getDocument() | Document | {@code Element} düğümünü içeren XML dokümanını alır. |
getName() | String | Element düğümünün yerel adını alır. |
getNamespace() | Namespace | Element düğümünün ad alanını alır. |
getNamespace(prefix) | Namespace | Element düğümü için belirtilen ön ekle başlayan ad alanını alır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getQualifiedName() | String | Element düğümünün yerel adını ve ad alanı önekini [namespacePrefix]:[localName] biçiminde alır. |
getText() | String | Element düğümünün metin değerini alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
isAncestorOf(other) | Boolean | Bu Element düğümünün, belirli bir Element düğümünün doğrudan mı yoksa dolaylı üst öğesi mi olduğunu belirler. |
isRootElement() | Boolean | Element düğümünün, dokümanın kök düğümü olup olmadığını belirler. |
removeAttribute(attribute) | Boolean | Bu Element düğümü için belirtilen özelliği (varsa) kaldırır. |
removeAttribute(attributeName) | Boolean | Bu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan (böyle bir özellik varsa) kaldırır. |
removeAttribute(attributeName, namespace) | Boolean | Bu Element düğümünün, belirtilen ad ve ad alanına sahip özelliğini (varsa) kaldırır. |
removeContent() | Content[] | {@code Element} düğümünün hemen alt öğeleri olan tüm düğümleri kaldırır. |
removeContent(content) | Boolean | Düğüm, {@code Element} düğümünün hemen bir alt öğesiyse belirtilen düğümü kaldırır. |
removeContent(index) | Content | Belirtilen dizindeki düğümü, {@code Element} düğümünün hemen alt öğesi olan tüm düğümler arasından kaldırır. |
setAttribute(attribute) | Element | Bu Element düğümü için belirtilen özelliği ayarlar. |
setAttribute(name, value) | Element | Bu Element düğümünün özelliğini verilen ada ve değere sahip olup ad alanı olmadan ayarlar. |
setAttribute(name, value, namespace) | Element | Bu Element düğümünün özelliğini verilen ad, değer ve ad alanıyla ayarlar. |
setName(name) | Element | Element düğümünün yerel adını ayarlar. |
setNamespace(namespace) | Element | Element düğümünün ad alanını ayarlar. |
setText(text) | Element | Element düğümünün metin değerini ayarlar. |
EntityRef
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getName() | String | EntityReference düğümünün adını alır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getPublicId() | String | EntityReference düğümünün genel kimliğini alır. |
getSystemId() | String | EntityReference düğümünün sistem kimliğini alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
setName(name) | EntityRef | EntityReference düğümünün adını ayarlar. |
setPublicId(id) | EntityRef | EntityReference düğümünün genel kimliğini ayarlar. |
setSystemId(id) | EntityRef | EntityReference düğümünün sistem kimliğini ayarlar. |
Format
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
format(document) | String | Belirtilen Document değerini biçimlendirilmiş bir dize olarak verir. |
format(element) | String | Belirtilen Element düğümünü biçimlendirilmiş bir dize olarak verir. |
setEncoding(encoding) | Format | Biçimlendiricinin kullanması gereken karakter kodlamasını ayarlar. |
setIndent(indent) | Format | Alt düğümlerin üst düğümlerine göre girinti eklemek için kullanılan dizeyi ayarlar. |
setLineSeparator(separator) | Format | Biçimlendirici normalde satır sonu eklediğinde eklenecek dizeyi ayarlar. |
setOmitDeclaration(omitDeclaration) | Format | Biçimlendiricinin XML bildirimini çıkarıp çıkarmayacağını belirler (ör. <?xml version="1.0"
encoding="UTF-8"?> ). |
setOmitEncoding(omitEncoding) | Format | Biçimlendiricinin, XML bildirimindeki kodlamayı (<?xml version="1.0" encoding="UTF-8"?> içindeki kodlama alanı gibi) çıkarıp çıkarmayacağını belirler. |
Namespace
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getPrefix() | String | Ad alanı önekini alır. |
getURI() | String | Ad alanı için URI'yi alır. |
ProcessingInstruction
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getData() | String | ProcessingInstruction düğümündeki her talimat için ham verileri alır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getTarget() | String | ProcessingInstruction düğümü için hedefi alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
Text
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
append(text) | Text | Belirtilen metni, düğümde mevcut olan herhangi bir içeriğe ekler. |
detach() | Content | Düğümü üst Element düğümünden çıkarır. |
getParentElement() | Element | Düğümün üst Element düğümünü alır. |
getText() | String | Text düğümünün metin değerini alır. |
getValue() | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır. |
setText(text) | Text | Text düğümünün metin değerini ayarlar. |
XmlService
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
ContentTypes | ContentType | XML içerik düğümü türlerini temsil eden bir numaralandırma. |
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
createCdata(text) | Cdata | Verilen değerle eklenmemiş bir CDATASection düğümü oluşturur. |
createComment(text) | Comment | Verilen değerle eklenmemiş bir Comment düğümü oluşturur. |
createDocType(elementName) | DocType | Kök Element düğümü için belirtilen adla eklenmemiş bir DocumentType düğümü oluşturur. |
createDocType(elementName, systemId) | DocType | Kök Element düğümü için eklenmemiş bir DocumentType düğümünü, harici alt küme verileri için de verilen adla ve sistem kimliğini kullanarak oluşturur. |
createDocType(elementName, publicId, systemId) | DocType | Kök Element düğümü için eklenmemiş, harici alt küme verileri için de verilen adla ve verilen genel kimlikle sistem kimliğiyle oluşturulmuş bir DocumentType düğümü oluşturur. |
createDocument() | Document | Boş bir XML dokümanı oluşturur. |
createDocument(rootElement) | Document | Belirtilen kök Element düğümüyle bir XML belgesi oluşturur. |
createElement(name) | Element | Belirtilen yerel adla ve ad alanı olmadan eklenmemiş bir Element düğümü oluşturur. |
createElement(name, namespace) | Element | Belirtilen yerel ad ve ad alanıyla eklenmemiş bir Element düğümü oluşturur. |
createText(text) | Text | Verilen değerle eklenmemiş bir Text düğümü oluşturur. |
getCompactFormat() | Format | Kompakt XML dokümanı çıktısı almak için bir Format nesnesi oluşturur. |
getNamespace(uri) | Namespace | Verilen URI ile bir Namespace oluşturur. |
getNamespace(prefix, uri) | Namespace | Belirtilen ön ek ve URI ile bir Namespace oluşturur. |
getNoNamespace() | Namespace | Gerçek bir ad alanının olmadığını temsil eden bir Namespace oluşturur. |
getPrettyFormat() | Format | İnsanların okuyabileceği bir XML belgesi çıkışı için Format nesnesi oluşturur. |
getRawFormat() | Format | Ham XML dokümanı çıkışı için bir Format nesnesi oluşturur. |
getXmlNamespace() | Namespace | Standart xml önekiyle bir Namespace oluşturur. |
parse(xml) | Document | XML'i doğrulamadan belirtilen XML'den bir Document oluşturur. |