XML Service

XML Hizmeti

Bu hizmet, komut dosyalarının XML dokümanlarını ayrıştırmasına, dokümanlar arasında 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 gösterimi.
ContentTypeXML içerik düğümlerinin türlerini temsil eden bir liste.
DocTypeBir XML DocumentType düğümünün temsili.
DocumentBir XML dokümanı temsili.
ElementBir XML Element düğümünün temsili.
EntityRefBir XML EntityReference düğümünün temsili.
FormatDaha da özelleştirilebilen üç önceden tanımlanmış biçim içeren bir XML dokümanı çıkışı biçimlendiricisi.
NamespaceBir XML ad alanının gösterimi.
ProcessingInstructionBir XML ProcessingInstruction düğümünün temsili.
TextBir XML Text düğümünün temsili.
XmlServiceBu hizmet, komut dosyalarının XML dokümanlarını ayrıştırmasına, dokümanlarda gezinmesine ve programatik 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ı belirler.
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 mevcut olan içeriğe ekler.
detach()ContentDüğümü, üst Element düğümünden ayırı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, 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()ContentDüğümü, üst Element düğümünden ayırı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, 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()CdataDüğümü, otomatik tamamlama amacıyla CDATASection düğümü olarak yayınlar.
asComment()CommentDüğümü, otomatik tamamlama amacıyla Comment düğümü olarak yayınlar.
asDocType()DocTypeDüğümü, otomatik tamamlama amacıyla DocumentType düğümü olarak yayınlar.
asElement()ElementDüğümü, otomatik tamamlama amacıyla Element düğümü olarak yayınlar.
asEntityRef()EntityRefDüğümü, otomatik tamamlama amacıyla EntityReference düğümü olarak yayınlar.
asProcessingInstruction()ProcessingInstructionDüğümü, otomatik tamamlama amacıyla ProcessingInstruction düğümü olarak yayınlar.
asText()TextDüğümü, otomatik tamamlama amacıyla Text düğümü olarak yayınlar.
detach()ContentDüğümü, üst Element düğümünden ayırır.
getParentElement()ElementDüğümün üst Element düğümünü alır.
getType()ContentTypeNodun 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, belgede göründükleri sırayla alır.

ContentType

Özellikler

MülkTürAçıklama
CDATAEnumXML CDATASection düğümü.
COMMENTEnumXML Comment düğümü.
DOCTYPEEnumXML DocumentType düğümü.
ELEMENTEnumXML Element düğümü.
ENTITYREFEnumXML EntityReference düğümü.
PROCESSINGINSTRUCTIONEnumXML ProcessingInstruction düğümü.
TEXTEnumXML Text düğümü.

DocType

Yöntemler

YöntemDönüş türüKısa açıklama
detach()ContentDüğümü, üst Element düğümünden ayırır.
getElementName()StringDocType beyanında belirtilen kök Element düğümünün adını alır.
getInternalSubset()StringDocumentType düğümünün 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 herkese açık 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, belgede göründükleri sırayla alır.
setElementName(name)DocTypeDocType beyanında 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 belirler.
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ü, belgenin doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizinde ekler.
cloneContent()Content[]Dokümanın doğrudan alt öğeleri olan tüm düğümlerin eksiz kopyalarını oluşturur.
detachRootElement()ElementDokümanın 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 öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü alır.
getContentSize()IntegerDokümanın doğrudan alt öğeleri olan düğümlerin sayısını alır.
getDescendants()Content[]Belgenin doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, belgede göründükleri sırayla alır.
getDocType()DocTypeDokümanın DocType bildirimini alır.
getRootElement()ElementDokümanın kök Element düğümünü alır.
hasRootElement()BooleanDokümanda kök Element düğümü olup olmadığını belirler.
removeContent()Content[]Dokümanın doğrudan alt öğeleri olan tüm düğümleri kaldırır.
removeContent(content)BooleanDüğüm, dokümanın doğrudan alt öğesiyse söz konusu düğümü kaldırır.
removeContent(index)ContentBelgenin 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 doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizinde ekler.
cloneContent()Content[]{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin eksiz kopyalarını oluşturur.
detach()ContentDüğümü, üst Element düğümünden ayırır.
getAllContent()Content[]{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri alır.
getAttribute(name)AttributeBelirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini 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 ve ad alanı içermeyen ilk Element düğümünü alır. Bu Element düğümünün doğrudan alt öğesidir.
getChild(name, namespace)ElementBelirtilen 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)StringDüğüm, Element düğümünün doğrudan alt öğesiyse düğümün adının ve ad alanının olmadığı metin değerini alır.
getChildText(name, namespace)StringNod, 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, belgede göründükleri sırada alır.
getChildren(name)Element[]Belirtilen ada sahip 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[]Belirtilen ada ve ad alanına sahip olan ve 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.
getContent(index)Content{@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 öğeleri 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, 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 eke sahip 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ı ön ekini [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 veya dolaylı bir üst öğesi olup olmadığını 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 verilen özelliği (varsa) kaldırır.
removeAttribute(attributeName)BooleanBelirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini kaldırır (varsa).
removeAttribute(attributeName, namespace)BooleanBelirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini (varsa) kaldırır.
removeContent()Content[]{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri kaldırır.
removeContent(content)BooleanDüğüm, {@code Element} düğümünün doğrudan alt öğesiyse söz konusu düğümü kaldırır.
removeContent(index)Content{@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, ad ve değer ile ad alanı olmadan ayarlar.
setAttribute(name, value, namespace)ElementBu Element düğümünün özelliğini, belirtilen 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ı belirler.
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 ayırı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 herkese açık 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, 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ş dize olarak döndürür.
format(element)StringBelirtilen Element düğümünü biçimlendirilmiş bir dize olarak döndürür.
setEncoding(encoding)FormatDüzenleyicinin kullanması gereken karakter kodlamasını ayarlar.
setIndent(indent)FormatAlt düğümleri ebeveynlerine göre girintili hale getirmek için kullanılan dizeyi ayarlar.
setLineSeparator(separator)FormatDüzenleyici normalde satır sonu eklediğinde eklenecek dizeyi ayarlar.
setOmitDeclaration(omitDeclaration)FormatDüzenleyicinin XML bildirimini (ör. <?xml version="1.0" encoding="UTF-8"?>) atlayıp atlamayacağı belirlenir.
setOmitEncoding(omitEncoding)FormatBiçimlendiricinin, XML beyanında kodlamayı (ör. <?xml version="1.0" encoding="UTF-8"?> içindeki kodlama alanı) atlayıp atlamayacağı ayarlar.

Namespace

Yöntemler

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

ProcessingInstruction

Yöntemler

YöntemDönüş türüKısa açıklama
detach()ContentDüğümü, üst Element düğümünden ayırır.
getData()StringProcessingInstruction düğümdeki her talimat için ham verileri alır.
getParentElement()ElementDüğümün üst Element düğümünü alır.
getTarget()StringProcessingInstruction düğümünün hedefini 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.

Text

Yöntemler

YöntemDönüş türüKısa açıklama
append(text)TextBelirtilen metni, düğümde zaten mevcut olan içeriğe ekler.
detach()ContentDüğümü, üst Element düğümünden ayırı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, 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 liste.

Yöntemler

YöntemDönüş türüKısa açıklama
createCdata(text)CdataBelirtilen değere sahip, bağlanmamış bir CDATASection düğümü oluşturur.
createComment(text)CommentBelirtilen değere sahip, bağlanmamış 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 belirtilen ada sahip ve harici alt küme verileri için belirtilen sistem kimliğine sahip, bağlı olmayan bir DocumentType düğümü oluşturur.
createDocType(elementName, publicId, systemId)DocTypeKök Element düğümü için belirtilen ada sahip ve harici alt küme verileri için belirtilen herkese açık kimliğe ve sistem kimliğine sahip, bağlı olmayan bir DocumentType düğümü oluşturur.
createDocument()DocumentBoş bir XML dokümanı oluşturur.
createDocument(rootElement)DocumentBelirtilen kök Element düğümünü içeren bir XML belgesi oluşturur.
createElement(name)ElementBelirtilen yerel ada sahip ve ad alanı içermeyen, bağlanmamış bir Element düğümü oluşturur.
createElement(name, namespace)ElementBelirtilen yerel ada ve ad alanına sahip, bağlanmamış bir Element düğümü oluşturur.
createText(text)TextBelirtilen değere sahip, bağlanmamış bir Text düğümü oluşturur.
getCompactFormat()FormatKompakt bir XML dokümanı oluşturmak için bir Format nesnesi oluşturur.
getNamespace(uri)NamespaceBelirtilen 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ı gösteren bir Namespace oluşturur.
getPrettyFormat()FormatKullanıcı tarafından okunabilir bir XML belgesi oluşturmak için bir Format nesnesi oluşturur.
getRawFormat()FormatHam XML dokümanı yayınlamak için bir Format nesnesi oluşturur.
getXmlNamespace()NamespaceStandart xml ön ekiyle bir Namespace oluşturur.
parse(xml)DocumentXML'yi doğrulamadan, belirtilen XML'den bir Document oluşturur.