XML Service

XML Hizmeti

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

AdKısa açıklama
AttributeBir XML özelliğinin gösterimi.
CdataXML CDATASection düğümünü temsil eder.
CommentXML Comment düğümünü temsil eder.
ContentGenel bir XML düğümünü temsil eder.
ContentTypeXML içerik düğümü türlerini temsil eden bir numaralandırma.
DocTypeXML DocumentType düğümünü temsil eder.
DocumentBir XML belgesinin temsili.
ElementXML Element düğümünü temsil eder.
EntityRefXML EntityReference düğümünü temsil eder.
FormatDaha fazla özelleştirilebilen önceden tanımlanmış üç biçime sahip XML belgesi çıkışı için bir biçimlendirici.
NamespaceBir XML ad alanını temsil eder.
ProcessingInstructionXML ProcessingInstruction düğümünü temsil eder.
TextXML Text düğümünü temsil eder.
XmlServiceBu 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öntemDö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öntemDönüş türüKısa açıklama
append(text)TextBelirtilen metni, düğümde mevcut olan herhangi bir içeriğe ekler.
detach()ContentDüğümü üst Element düğümünden çıkarır.
getParentElement()ElementDüğü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, dokümanda 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()ContentDüğümü üst Element düğümünden çıkarır.
getParentElement()ElementDüğü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, dokümanda 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()CdataDüğümü, otomatik tamamlama amacıyla bir CDATASection düğümü olarak yayınlar.
asComment()CommentDüğümü, otomatik tamamlama amacıyla bir Comment düğümü olarak yayınlar.
asDocType()DocTypeDüğümü, otomatik tamamlama amacıyla bir DocumentType düğümü olarak yayınlar.
asElement()ElementDüğümü, otomatik tamamlama amacıyla bir Element düğümü olarak yayınlar.
asEntityRef()EntityRefDüğümü, otomatik tamamlama amacıyla bir EntityReference düğümü olarak yayınlar.
asProcessingInstruction()ProcessingInstructionDüğümü, otomatik tamamlama amacıyla bir ProcessingInstruction düğümü olarak yayınlar.
asText()TextDüğümü, otomatik tamamlama amacıyla bir Text düğümü olarak yayınlar.
detach()ContentDüğümü üst Element düğümünden çıkarır.
getParentElement()ElementDüğümün üst Element düğümünü alır.
getType()ContentTypeDüğümün içerik türünü alır.
getValue()StringDüğü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

ÖzellikTü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()ContentDüğümü üst Element düğümünden çıkarır.
getElementName()StringDocType bildiriminde belirtilen kök Element düğümünün adını alır.
getInternalSubset()StringDocumentType düğümü için dahili alt küme verilerini alır.
getParentElement()ElementDüğümün üst Element düğümünü alır.
getPublicId()StringDocumentType düğümü için harici alt küme verilerinin genel kimliğini alır.
getSystemId()StringDocumentType düğümü için harici alt küme verilerinin sistem kimliğini alır.
getValue()StringDüğü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)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 genel 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ü dokümanın sonuna ekler.
addContent(index, content)DocumentBelirtilen 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()ElementBelgenin 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)ContentBelgenin doğrudan alt öğesi olan tüm düğümler arasında belirtilen dizindeki düğümü alır.
getContentSize()IntegerBelgenin 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()DocTypeBelgenin DocType bildirimini alır.
getRootElement()ElementBelgenin kök Element düğümünü alır.
hasRootElement()BooleanDokü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)BooleanDüğüm, dokümanın doğrudan alt öğesiyse belirtilen düğümü kaldırır.
removeContent(index)ContentBelirtilen dizindeki düğümü, dokümanın doğrudan alt öğesi olan tüm düğümler arasından 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 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()ContentDüğü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)AttributeBu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan alır.
getAttribute(name, namespace)AttributeBelirtilen 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)ElementBelirtilen 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)ElementBelirtilen 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)StringDüğü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)StringDüğü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()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 belirtilen ön ekle başlayan ad alanını alır.
getParentElement()ElementDüğü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, dokümanda 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ı üst öğesi mi 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 özelliğini, belirtilen ada sahip olup ad alanı olmadan (böyle bir özellik varsa) kaldırır.
removeAttribute(attributeName, namespace)BooleanBu 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)BooleanDüğüm, {@code Element} düğümünün hemen bir alt öğesiyse belirtilen düğümü kaldırır.
removeContent(index)ContentBelirtilen dizindeki düğümü, {@code Element} düğümünün hemen alt öğesi olan tüm düğümler arasından 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 ada ve değere sahip olup 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()ContentDüğümü üst Element düğümünden çıkarır.
getName()StringEntityReference düğümünün adını alır.
getParentElement()ElementDüğümün üst Element düğümünü alır.
getPublicId()StringEntityReference düğümünün genel kimliğini alır.
getSystemId()StringEntityReference 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, dokümanda 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 genel 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 verir.
setEncoding(encoding)FormatBiçimlendiricinin kullanması gereken karakter kodlamasını ayarlar.
setIndent(indent)FormatAlt düğümlerin üst düğümlerine göre girinti eklemek için kullanılan dizeyi ayarlar.
setLineSeparator(separator)FormatBiçimlendirici normalde satır sonu eklediğinde eklenecek dizeyi ayarlar.
setOmitDeclaration(omitDeclaration)FormatBiçimlendiricinin XML bildirimini çıkarıp çıkarmayacağını belirler (ör. <?xml version="1.0" encoding="UTF-8"?>).
setOmitEncoding(omitEncoding)FormatBiç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öntemDönüş türüKısa açıklama
getPrefix()StringAd alanı önekini alır.
getURI()StringAd alanı için URI'yi alır.

ProcessingInstruction

Yöntemler

YöntemDönüş türüKısa açıklama
detach()ContentDüğümü üst Element düğümünden çıkarır.
getData()StringProcessingInstruction düğümündeki her talimat için ham verileri alır.
getParentElement()ElementDüğümün üst Element düğümünü alır.
getTarget()StringProcessingInstruction düğümü için hedefi alır.
getValue()StringDüğü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öntemDönüş türüKısa açıklama
append(text)TextBelirtilen metni, düğümde mevcut olan herhangi bir içeriğe ekler.
detach()ContentDüğümü üst Element düğümünden çıkarır.
getParentElement()ElementDüğü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, dokümanda göründükleri sırayla alır.
setText(text)TextText düğümünün metin değerini ayarlar.

XmlService

Özellikler

ÖzellikTürAçıklama
ContentTypesContentTypeXML içerik düğümü türlerini temsil eden bir numaralandırma.

Yöntemler

YöntemDönüş türüKısa açıklama
createCdata(text)CdataVerilen değerle eklenmemiş bir CDATASection düğümü oluşturur.
createComment(text)CommentVerilen değerle eklenmemiş bir Comment düğümü oluşturur.
createDocType(elementName)DocTypeKök Element düğümü için belirtilen adla eklenmemiş bir DocumentType düğümü oluşturur.
createDocType(elementName, systemId)DocTypeKö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)DocTypeKö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()DocumentBoş bir XML dokümanı oluşturur.
createDocument(rootElement)DocumentBelirtilen kök Element düğümüyle bir XML belgesi oluşturur.
createElement(name)ElementBelirtilen yerel adla ve ad alanı olmadan eklenmemiş bir Element düğümü oluşturur.
createElement(name, namespace)ElementBelirtilen yerel ad ve ad alanıyla eklenmemiş bir Element düğümü oluşturur.
createText(text)TextVerilen değerle eklenmemiş bir Text düğümü oluşturur.
getCompactFormat()FormatKompakt XML dokümanı çıktısı almak için bir Format nesnesi oluşturur.
getNamespace(uri)NamespaceVerilen URI ile bir Namespace oluşturur.
getNamespace(prefix, uri)NamespaceBelirtilen ön ek ve URI ile bir Namespace oluşturur.
getNoNamespace()NamespaceGerç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()FormatHam XML dokümanı çıkışı için bir Format nesnesi oluşturur.
getXmlNamespace()NamespaceStandart xml önekiyle bir Namespace oluşturur.
parse(xml)DocumentXML'i doğrulamadan belirtilen XML'den bir Document oluşturur.