XML Service

XML Hizmeti

Bu hizmet, komut dosyalarının ayrıştırmasına, gezinmesine ve programatik olarak oluşturmalarına olanak tanır. XML dokümanları.

// 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.
CdataXML CDATASection düğümünün temsili.
CommentXML 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.
DocTypeXML DocumentType düğümünün temsili.
DocumentBir XML dokümanının temsili.
ElementXML Element düğümünün temsili.
EntityRefXML EntityReference düğümünün temsili.
FormatDaha sonra izlenebilecek önceden tanımlanmış üç biçime sahip, XML belgesi çıktısı almak için bir biçimlendirici özelleştirilmiş.
NamespaceXML ad alanının temsilidir.
ProcessingInstructionXML ProcessingInstruction düğümünün temsili.
TextXML Text düğümünün temsili.
XmlServiceBu hizmet, komut dosyalarının XML dokümanlarını ayrıştırmasına, programlamasına 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Özniteliğ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 herhangi bir 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 şu sırayla alır: bu öğeler dokümanda görünü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 şu sırayla alır: bu öğeler dokümanda görünü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 ayırı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 şu sırayla alır: bu öğeler dokümanda görünür.

ContentType

Özellikler

ÖzellikTü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 bildiriminde belirtilen kök Element düğümünün adını alır.
getInternalSubset()StringDocumentType düğümünün dahili alt kümesi 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 şu sırayla alır: bu öğeler dokümanda görünür.
setElementName(name)DocTypeDocType içinde belirtilecek kök Element düğümünün adını ayarlar beyanı.
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ü dokümanın sonuna ekler.
addContent(index, content)DocumentVerilen dizinde verilen düğümü, uygulayacaksınız.
cloneContent()Content[]Dokümanın en yakın alt öğeleri olan tüm düğümlerin ekli olmayan 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 en yakın alt öğesi olan tüm düğümleri alır.
getContent(index)Content uygulayacaksınız.
getContentSize()IntegerDokümanın ilk alt öğeleri olan düğümlerin sayısını alır.
getDescendants()Content[]Dokümanın doğrudan veya dolaylı alt öğesi olan tüm düğümleri, görünür.
getDocType()DocTypeDokümanın DocType bildirimini alır.
getRootElement()ElementBelgenin kök Element düğümünü alır.
hasRootElement()BooleanDokümanda kök Element düğümünün olup olmadığını belirler.
removeContent()Content[]Dokümanın ilk 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)Content uygulayacaksınız.
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)ElementVerilen dizinde verilen düğümü, Element düğüm.
cloneContent()Content[]{@code Element} düğümünün en yakın alt öğeleri olan tüm düğümlerin ekli olmayan kopyalarını oluşturur.
detach()ContentDüğümü üst Element düğümünden ayırır.
getAllContent()Content[]{@code Element} düğümünün ilk alt öğeleri olan tüm düğümleri alır.
getAttribute(name)AttributeVerilen ada sahip ve ad alanı olmadan bu Element düğümünün özelliğini alır.
getAttribute(name, namespace)AttributeBelirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini alır.
getAttributes()Attribute[]Bu Element düğümüne ilişkin tüm özellikleri, dokümanda göründükleri sırayla alır.
getChild(name)ElementBelirtilen ada sahip ilk Element düğümünü alır ve hemen bu Element düğümünün alt öğesidir.
getChild(name, namespace)ElementBelirtilen ada ve ad alanına sahip ilk Element düğümünü alır ve bu Element düğümünün alt öğesidir.
getChildText(name)StringDüğüm bir Element düğümünün hemen alt öğesidir.
getChildText(name, namespace)StringDüğüm doğrudan bir düğümse verilen ada ve ad alanına sahip düğümün metin değerini alır Element düğümünün alt öğesidir.
getChildren()Element[]ElementElement ve bunların belgede görünmesini sağlayın.
getChildren(name)Element[]Verilen ada sahip ve hemen alt öğe olan ad alanı içermeyen tüm Element düğümlerini alır bu Element düğümünü dokümanda göründükleri sırayla görürsünüz.
getChildren(name, namespace)Element[]Verilen ada ve ad alanına sahip tüm Element düğümlerini alır ve bu düğümler bu Element düğümünü dokümanda göründükleri sırayla görürsünüz.
getContent(index)Content {@code Öğesi} düğümü.
getContentSize()Integer{@code Element} düğümünün ilk alt öğeleri 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, görünür.
getDocument()Document{@code Öğesi} 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 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 şu sırayla alır: bu öğeler dokümanda görünü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)BooleanElement düğümü için belirtilen özelliği (varsa) kaldırır.
removeAttribute(attributeName)BooleanAşağıdaki durumda, belirtilen ada sahip ve ad alanı olmadan bu Element düğümünün özelliğini kaldırır böyle bir özellik bulunuyor.
removeAttribute(attributeName, namespace)BooleanBelirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini kaldırır (bu durum söz konusuysa) bir özellik var.
removeContent()Content[]{@code Element} düğümünün ilk alt öğesi olan tüm düğümleri kaldırır.
removeContent(content)BooleanDüğüm, {@code Element} düğümünün ilk alt öğesiyse belirtilen düğümü kaldırır.
removeContent(index)Content {@code Öğesi} düğümü.
setAttribute(attribute)ElementBu Element düğümü için verilen özelliği ayarlar.
setAttribute(name, value)ElementBu Element düğümünün özelliğini verilen ada, değere ve ad alanına sahip olmadan ayarlar.
setAttribute(name, value, namespace)ElementBu Element düğümünün özelliğini verilen ad, değer ve ad ile 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 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 şu sırayla alır: bu öğeler dokümanda görünü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 öğesini 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üğümlere üst düğümlerine göre girinti eklemek için kullanılan dizeyi ayarlar.
setLineSeparator(separator)FormatBiçimlendirmecinin normalde satır sonu eklediği zaman eklenecek dizeyi ayarlar.
setOmitDeclaration(omitDeclaration)FormatBiçimlendiricinin, <?xml version="1.0" encoding="UTF-8"?> gibi XML bildirimini atlayıp atlamayacağını belirler.
setOmitEncoding(omitEncoding)FormatBiçimlendiricinin, XML bildirimindeki gibi kodlamayı atlamasını kodlama alanına sahip olmak için <?xml version="1.0" encoding="UTF-8"?> biçimini kullanın.

Namespace

Yöntemler

YöntemDönüş türüKısa açıklama
getPrefix()StringAd alanının önekini alır.
getURI()StringAd alanının URI'sını 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üğü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 şu sırayla alır: bu öğeler dokümanda görünür.

Text

Yöntemler

YöntemDönüş türüKısa açıklama
append(text)TextBelirtilen metni, düğümde zaten bulunan herhangi bir 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 şu sırayla alır: bu öğeler dokümanda görünür.
setText(text)TextText düğümünün metin değerini ayarlar.

XmlService

Özellikler

ÖzellikTü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ğerle, ekli olmayan bir CDATASection düğümü oluşturur.
createComment(text)CommentBelirtilen değerle, ekli olmayan bir Comment düğümü oluşturur.
createDocType(elementName)DocTypeElement kök düğümü için ekli olmayan bir DocumentType düğümü oluşturur yerine verilen ad kullanılır.
createDocType(elementName, systemId)DocTypeElement kök düğümü için ekli olmayan bir DocumentType düğümü oluşturur verilen ad ve harici alt küme verilerinin sistem kimliği ile birlikte girin.
createDocType(elementName, publicId, systemId)DocTypeElement kök düğümü için ekli olmayan bir DocumentType düğümü oluşturur verilen ad ve harici alt küme verileri için verilen genel kimlik ve sistem kimliğiyle birlikte girin.
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 ada sahip ve ad alanı olmayan, ekli olmayan bir Element düğümü oluşturur.
createElement(name, namespace)ElementBelirtilen yerel ada ve ad alanına sahip, ekli olmayan bir Element düğümü oluşturur.
createText(text)TextBelirtilen değerle, ekli olmayan 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)NamespaceVerilen ö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 tarafından okunabilen bir XML dokümanı çıktısı almak için bir Format nesnesi oluşturur.
getRawFormat()FormatHam XML belgesi çıkışı yapmak için bir Format nesnesi oluşturur.
getXmlNamespace()NamespaceStandart xml ön ekine sahip bir Namespace oluşturur.
parse(xml)DocumentBelirtilen XML'den, XML'i doğrulamadan bir Document oluşturur.