XML Service

XML Hizmeti

Bu hizmet, komut dosyalarının XML belgelerini ayrıştırmasına, belgelerde 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

AdKısa açıklama
AttributeBir XML özelliğinin temsili.
CdataBir XML CDATASection düğümünün temsili.
CommentBir XML Comment düğümünün temsili.
ContentGenel bir XML düğümünün temsili.
ContentTypeXML içerik düğümlerinin türlerini temsil eden bir numaralandırma.
DocTypeBir XML DocumentType düğümünün temsili.
DocumentXML dokümanının temsili.
ElementBir XML Element düğümünün temsili.
EntityRefBir XML EntityReference düğümünün temsili.
FormatÜç önceden tanımlanmış biçime sahip ve daha fazla özelleştirilebilen bir XML belgesi oluşturmak için biçimlendirici.
NamespaceXML ad alanının temsili.
ProcessingInstructionBir XML ProcessingInstruction düğümünün temsili.
TextBir XML Text düğümünün temsili.
XmlServiceBu hizmet, komut dosyalarının XML belgelerini ayrıştırmasına, belgelerde gezinmesine ve programatik olarak XML belgeleri oluşturmasına olanak tanır.

Attribute

Yöntemler

YöntemDönüş türüKısa açıklama
getName()StringÖzelliğin yerel adını alır.
getNamespace()Namespace|nullÖ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öntemDönüş türüKısa açıklama
append(text)TextBelirtilen metni, düğümde zaten bulunan tüm içeriklerin sonuna ekler.
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getText()StringText düğümünün metin değerini alır.
getValue()StringDüğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır.
setText(text)TextText düğümünün metin değerini ayarlar.

Comment

Yöntemler

YöntemDönüş türüKısa açıklama
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getText()StringComment düğümünün metin değerini alır.
getValue()StringDüğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır.
setText(text)CommentComment düğümünün metin değerini ayarlar.

Content

Yöntemler

YöntemDönüş türüKısa açıklama
asCdata()Cdata|nullOtomatik tamamlama amacıyla düğümü CDATASection düğümü olarak yayınlar.
asComment()Comment|nullOtomatik tamamlama amacıyla düğümü Comment düğümü olarak yayınlar.
asDocType()DocType|nullOtomatik tamamlama amacıyla düğümü DocumentType düğümü olarak yayınlar.
asElement()Element|nullOtomatik tamamlama amacıyla düğümü Element düğümü olarak yayınlar.
asEntityRef()EntityRef|nullOtomatik tamamlama amacıyla düğümü EntityReference düğümü olarak yayınlar.
asProcessingInstruction()ProcessingInstruction|nullOtomatik tamamlama amacıyla düğümü ProcessingInstruction düğümü olarak yayınlar.
asText()Text|nullOtomatik tamamlama amacıyla düğümü Text düğümü olarak yayınlar.
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getType()ContentTypeDüğümün içerik türünü alır.
getValue()StringBelgede göründükleri sırayla, düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini alır.

ContentType

Özellikler

MülkTürAçıklama
CDATAEnumBir XML CDATASection düğümü.
COMMENTEnumBir XML Comment düğümü.
DOCTYPEEnumBir XML DocumentType düğümü.
ELEMENTEnumBir XML Element düğümü.
ENTITYREFEnumBir XML EntityReference düğümü.
PROCESSINGINSTRUCTIONEnumBir XML ProcessingInstruction düğümü.
TEXTEnumBir XML Text düğümü.

DocType

Yöntemler

YöntemDönüş türüKısa açıklama
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getElementName()StringElement bildiriminde belirtilen kök DocType düğümünün adını alır.
getInternalSubset()StringDocumentType düğümü için dahili alt küme verilerini alır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getPublicId()StringDocumentType düğümü için harici alt küme verilerinin herkese açık kimliğini alır.
getSystemId()StringDocumentType düğümü için harici alt küme verilerinin sistem kimliğini alır.
getValue()StringBelgede göründükleri sırayla, düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini alır.
setElementName(name)DocTypeDocType bildiriminde belirtilecek kök Element düğümünün adını ayarlar.
setInternalSubset(data)DocTypeDocumentType düğümü için dahili alt küme verilerini ayarlar.
setPublicId(id)DocTypeDocumentType düğümü için harici alt küme verilerinin herkese açık kimliğini ayarlar.
setSystemId(id)DocTypeDocumentType düğümü için harici alt küme verilerinin sistem kimliğini ayarlar.

Document

Yöntemler

YöntemDönüş türüKısa açıklama
addContent(content)DocumentBelirtilen düğümü belgenin sonuna ekler.
addContent(index, content)DocumentBelirtilen düğümü, dokümanın doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizine ekler.
cloneContent()Content[]Dokümanın doğrudan alt öğeleri olan tüm düğümlerin eklenmemiş kopyalarını oluşturur.
detachRootElement()Element|nullDokümanın kök Element düğümünü ayırır ve döndürür.
getAllContent()Content[]Belgenin doğrudan alt öğesi olan tüm düğümleri alır.
getContent(index)Content|nullBelgenin doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü alır.
getContentSize()IntegerBelgenin doğrudan alt öğesi olan düğümlerin sayısını alır.
getDescendants()Content[]Belgede göründükleri sırayla, belgenin doğrudan veya dolaylı alt öğeleri olan tüm düğümleri alır.
getDocType()DocType|nullBelgenin DocTypebildirimini alır.
getRootElement()Element|nullDokümanın kök Element düğümünü alır.
hasRootElement()BooleanBelgenin bir kök Element düğümü olup olmadığını belirler.
removeContent()Content[]Dokümanın doğrudan alt öğesi olan tüm düğümleri kaldırır.
removeContent(content)BooleanBelirtilen düğüm, dokümanın doğrudan alt öğesi ise kaldırılır.
removeContent(index)Content|nullBelgenin doğrudan alt öğeleri olan tüm düğümler arasında, belirtilen dizindeki düğümü kaldırır.
setDocType(docType)DocumentDokümanın DocType bildirimini ayarlar.
setRootElement(element)DocumentDokümanın kök Element düğümünü ayarlar.

Element

Yöntemler

YöntemDönüş türüKısa açıklama
addContent(content)ElementBelirtilen düğümü Element düğümünün son alt öğesi olarak ekler.
addContent(index, content)ElementBelirtilen düğümü, Element düğümünün en yakın alt öğeleri olan tüm düğümler arasında belirtilen dizine ekler.
cloneContent()Content[]{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin bağlantısız kopyalarını oluşturur.
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getAllContent()Content[]{@code Element} düğümünün doğrudan alt öğesi olan tüm düğümleri alır.
getAttribute(name)Attribute|nullBelirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini alır.
getAttribute(name, namespace)Attribute|nullBelirtilen 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|nullBelirtilen ada sahip ve ad alanı olmayan, bu Element düğümünün doğrudan alt öğesi olan ilk Element düğümünü alır.
getChild(name, namespace)Element|nullBelirtilen ada ve ad alanına sahip olan ve bu Element düğümünün doğrudan alt öğesi olan ilk Element düğümünü alır.
getChildText(name)String|nullDüğüm, Element düğümünün doğrudan alt öğesiyse belirtilen ada ve ad alanına sahip olmayan düğümün metin değerini alır.
getChildText(name, namespace)String|nullDüğüm, Element düğümünün doğrudan alt öğesiyse belirtilen ada ve ad alanına sahip düğümün metin değerini alır.
getChildren()Element[]Bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır.
getChildren(name)Element[]Belirli bir ada sahip olan ve ad alanı içermeyen, bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır.
getChildren(name, namespace)Element[]Belirli bir ada ve ad alanına sahip olan ve bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, belgede göründükleri sırayla alır.
getContent(index)Content|null{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında, belirtilen dizindeki düğümü alır.
getContentSize()Integer{@code Element} düğümünün doğrudan alt öğesi olan düğümlerin sayısını alır.
getDescendants()Content[]{@code Element} düğümünün doğrudan veya dolaylı alt öğesi olan tüm düğümleri, belgede göründükleri sırayla alır.
getDocument()Document{@code Element} düğümünü içeren XML dokümanını alır.
getName()StringElement düğümünün yerel adını alır.
getNamespace()NamespaceElement düğümünün ad alanını alır.
getNamespace(prefix)NamespaceElement düğümü için belirli bir ön ekle ad alanını alır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getQualifiedName()StringElement düğümünün yerel adını ve ad alanı önekini [namespacePrefix]:[localName] biçiminde alır.
getText()StringElement düğümünün metin değerini alır.
getValue()StringDüğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır.
isAncestorOf(other)BooleanBu Element düğümünün, belirli bir Element düğümünün doğrudan mı yoksa dolaylı olarak mı üst öğesi olduğunu belirler.
isRootElement()BooleanElement düğümünün dokümanın kök düğümü olup olmadığını belirler.
removeAttribute(attribute)BooleanBu Element düğümü için belirtilen özelliği (varsa) kaldırır.
removeAttribute(attributeName)BooleanBu Element düğümünün, belirtilen ada sahip ve ad alanı içermeyen özelliğini kaldırır (böyle bir özellik varsa).
removeAttribute(attributeName, namespace)BooleanBu Element düğümünün, belirtilen ada ve ad alanına sahip özelliğini (varsa) kaldırır.
removeContent()Content[]{@code Element} düğümünün doğrudan alt öğesi olan tüm düğümleri kaldırır.
removeContent(content)BooleanBelirtilen düğüm, {@code Element} düğümünün doğrudan alt öğesiyse kaldırır.
removeContent(index)Content|null{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında, belirtilen dizindeki düğümü kaldırır.
setAttribute(attribute)ElementBu Element düğümü için belirtilen özelliği ayarlar.
setAttribute(name, value)ElementBu Element düğümünün özelliğini, verilen ad ve değerle, ad alanı olmadan ayarlar.
setAttribute(name, value, namespace)ElementBu Element düğümünün özelliğini verilen ad, değer ve ad alanıyla ayarlar.
setName(name)ElementElement düğümünün yerel adını ayarlar.
setNamespace(namespace)ElementElement düğümünün ad alanını ayarlar.
setText(text)ElementElement düğümünün metin değerini ayarlar.

EntityRef

Yöntemler

YöntemDönüş türüKısa açıklama
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getName()StringEntityReference düğümünün adını alır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getPublicId()String|nullEntityReference düğümünün herkese açık kimliğini alır.
getSystemId()String|nullEntityReference düğümünün sistem kimliğini alır.
getValue()StringDüğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır.
setName(name)EntityRefEntityReference düğümünün adını ayarlar.
setPublicId(id)EntityRefEntityReference düğümünün herkese açık kimliğini ayarlar.
setSystemId(id)EntityRefEntityReference düğümünün sistem kimliğini ayarlar.

Format

Yöntemler

YöntemDönüş türüKısa açıklama
format(document)StringBelirtilen Document değerini biçimlendirilmiş bir dize olarak verir.
format(element)StringBelirtilen Element düğümünü biçimlendirilmiş bir dize olarak çıkarır.
setEncoding(encoding)FormatBiçimlendiricinin kullanması gereken karakter kodlamasını ayarlar.
setIndent(indent)FormatAlt düğümleri üst düğümlerine göre girintilemek için kullanılan dizeyi ayarlar.
setLineSeparator(separator)FormatBiçimlendiricinin normalde satır sonu ekleyeceği her yere eklenecek dizeyi ayarlar.
setOmitDeclaration(omitDeclaration)FormatBiçimlendiricinin <?xml version="1.0" encoding="UTF-8"?> gibi XML bildirimini atlayıp atlamayacağını ayarlar.
setOmitEncoding(omitEncoding)FormatBiçimlendiricinin, XML bildirimindeki kodlamayı (ör. <?xml version="1.0" encoding="UTF-8"?> içindeki kodlama alanı) atlayıp atlamayacağını ayarlar.

Namespace

Yöntemler

YöntemDönüş türüKısa açıklama
getPrefix()StringAd alanı için ön eki alır.
getURI()StringAd alanının URI'sini alır.

ProcessingInstruction

Yöntemler

YöntemDönüş türüKısa açıklama
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getData()StringProcessingInstruction düğümündeki her talimat için ham verileri alır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getTarget()StringProcessingInstruction düğümünün hedefini alır.
getValue()StringBelgede göründükleri sırayla, düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini alır.

Text

Yöntemler

YöntemDönüş türüKısa açıklama
append(text)TextBelirtilen metni, düğümde zaten bulunan tüm içeriklerin sonuna ekler.
detach()Content|nullDüğümü üst Element düğümünden ayırır.
getParentElement()Element|nullDüğümün üst Element düğümünü alır.
getText()StringText düğümünün metin değerini alır.
getValue()StringDüğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır.
setText(text)TextText düğümünün metin değerini ayarlar.

XmlService

Özellikler

MülkTürAçıklama
ContentTypesContentTypeXML içerik düğümlerinin türlerini temsil eden bir numaralandırma.

Yöntemler

YöntemDönüş türüKısa açıklama
createCdata(text)CdataBelirtilen değere sahip, bağlantısız bir CDATASection düğümü oluşturur.
createComment(text)CommentBelirtilen değere sahip, bağlantısız bir Comment düğümü oluşturur.
createDocType(elementName)DocTypeBelirtilen ada sahip kök Element düğümü için eklenmemiş bir DocumentType düğümü oluşturur.
createDocType(elementName, systemId)DocTypeKök Element düğümü için, verilen adla ve harici alt küme verileri için verilen sistem kimliğiyle birlikte eklenmemiş bir DocumentType düğümü oluşturur.
createDocType(elementName, publicId, systemId)DocTypeKök Element düğümü için, verilen adla, harici alt küme verileri için verilen genel kimlik ve sistem kimliğiyle birlikte, eklenmemiş bir DocumentType düğümü oluşturur.
createDocument()DocumentBoş bir XML dokümanı oluşturur.
createDocument(rootElement)DocumentBelirtilen kök Element düğümüyle bir XML dokümanı oluşturur.
createElement(name)ElementBelirtilen yerel ada sahip ve ad alanı olmayan, ayrılmış bir Element düğümü oluşturur.
createElement(name, namespace)ElementBelirtilen yerel ada ve ad alanına sahip, ayrılmamış bir Element düğümü oluşturur.
createText(text)TextBelirtilen değere sahip, bağlantısız bir Text düğümü oluşturur.
getCompactFormat()FormatKısa bir XML belgesi oluşturmak için Format nesnesi oluşturur.
getNamespace(uri)NamespaceBelirtilen URI ile Namespace oluşturur.
getNamespace(prefix, uri)NamespaceBelirtilen önek ve URI ile bir Namespace oluşturur.
getNoNamespace()NamespaceGerçek bir ad alanının olmadığını gösteren bir Namespace oluşturur.
getPrettyFormat()FormatOkunabilir bir XML belgesi oluşturmak için Format nesnesi oluşturur.
getRawFormat()FormatHam XML dokümanı çıkışı için Format nesnesi oluşturur.
getXmlNamespace()NamespaceStandart xml önekine sahip bir Namespace oluşturur.
parse(xml)DocumentXML'yi doğrulamadan, verilen XML'den bir Document oluşturur.