XML Service

Mit diesem Dienst können Skripts XML-Dokumente parsen, darin navigieren und sie programmatisch erstellen.

// 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);
}

Klassen

Name	Kurzbeschreibung
`Attribute`	Eine Darstellung eines XML-Attributs.
`Cdata`	Eine Darstellung eines XML-`CDATASection`-Knotens.
`Comment`	Eine Darstellung eines XML-`Comment`-Knotens.
`Content`	Eine Darstellung eines generischen XML-Knotens.
`ContentType`	Eine Aufzählung, die die Typen von XML-Inhaltsknoten darstellt.
`DocType`	Eine Darstellung eines XML-`DocumentType`-Knotens.
`Document`	Eine Darstellung eines XML-Dokuments.
`Element`	Eine Darstellung eines XML-`Element`-Knotens.
`EntityRef`	Eine Darstellung eines XML-`EntityReference`-Knotens.
`Format`	Ein Formatierungstool für die Ausgabe eines XML-Dokuments mit drei vordefinierten Formaten, die weiter angepasst werden können.
`Namespace`	Eine Darstellung eines XML-Namespace.
`ProcessingInstruction`	Eine Darstellung eines XML-`ProcessingInstruction`-Knotens.
`Text`	Eine Darstellung eines XML-`Text`-Knotens.
`XmlService`	Mit diesem Dienst können Skripts XML-Dokumente parsen, darin navigieren und sie programmatisch erstellen.

`Attribute`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getName()`	`String`	Ruft den lokalen Namen des Attributs ab.
`getNamespace()`	`Namespace\|null`	Ruft den Namespace für das Attribut ab.
`getValue()`	`String`	Ruft den Wert des Attributs ab.
`setName(name)`	`Attribute`	Legt den lokalen Namen des Attributs fest.
`setNamespace(namespace)`	`Attribute`	Legt den Namespace für das Attribut fest.
`setValue(value)`	`Attribute`	Legt den Wert des Attributs fest.

`Cdata`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`append(text)`	`Text`	Hängt den angegebenen Text an alle Inhalte an, die bereits im Knoten vorhanden sind.
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getText()`	`String`	Ruft den Textwert des Knotens `Text` ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`setText(text)`	`Text`	Legt den Textwert des Knotens `Text` fest.

`Comment`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getText()`	`String`	Ruft den Textwert des Knotens `Comment` ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`setText(text)`	`Comment`	Legt den Textwert des Knotens `Comment` fest.

`Content`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`asCdata()`	`Cdata\|null`	Wandelt den Knoten für die automatische Vervollständigung in einen `CDATASection`-Knoten um.
`asComment()`	`Comment\|null`	Wandelt den Knoten für die automatische Vervollständigung in einen `Comment`-Knoten um.
`asDocType()`	`DocType\|null`	Wandelt den Knoten für die automatische Vervollständigung in einen `DocumentType`-Knoten um.
`asElement()`	`Element\|null`	Weist dem Knoten für die automatische Vervollständigung den Typ `Element` zu.
`asEntityRef()`	`EntityRef\|null`	Wandelt den Knoten für die automatische Vervollständigung in einen `EntityReference`-Knoten um.
`asProcessingInstruction()`	`ProcessingInstruction\|null`	Wandelt den Knoten für die automatische Vervollständigung in einen `ProcessingInstruction`-Knoten um.
`asText()`	`Text\|null`	Wandelt den Knoten für die automatische Vervollständigung in einen `Text`-Knoten um.
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getType()`	`ContentType`	Ruft den Inhaltstyp des Knotens ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.

`ContentType`

Attribute

Attribut	Typ	Beschreibung
`CDATA`	`Enum`	Ein XML-Knoten vom Typ `CDATASection`.
`COMMENT`	`Enum`	Ein XML-Knoten vom Typ `Comment`.
`DOCTYPE`	`Enum`	Ein XML-Knoten vom Typ `DocumentType`.
`ELEMENT`	`Enum`	Ein XML-Knoten vom Typ `Element`.
`ENTITYREF`	`Enum`	Ein XML-Knoten vom Typ `EntityReference`.
`PROCESSINGINSTRUCTION`	`Enum`	Ein XML-Knoten vom Typ `ProcessingInstruction`.
`TEXT`	`Enum`	Ein XML-Knoten vom Typ `Text`.

`DocType`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getElementName()`	`String`	Ruft den Namen des in der `DocType`-Deklaration angegebenen `Element`-Stammknotens ab.
`getInternalSubset()`	`String`	Ruft die internen Teilmengendaten für den Knoten `DocumentType` ab.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getPublicId()`	`String`	Ruft die öffentliche ID der externen Teilmengendaten für den Knoten `DocumentType` ab.
`getSystemId()`	`String`	Ruft die System-ID der externen Teilmengendaten für den Knoten `DocumentType` ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`setElementName(name)`	`DocType`	Legt den Namen des `Element`-Stammknotens fest, der in der `DocType`-Deklaration angegeben werden soll.
`setInternalSubset(data)`	`DocType`	Legt die internen Teilmengendaten für den Knoten `DocumentType` fest.
`setPublicId(id)`	`DocType`	Legt die öffentliche ID der externen Teilmengendaten für den Knoten `DocumentType` fest.
`setSystemId(id)`	`DocType`	Legt die System-ID der externen Teilmengendaten für den Knoten `DocumentType` fest.

`Document`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addContent(content)`	`Document`	Fügt den angegebenen Knoten am Ende des Dokuments an.
`addContent(index, content)`	`Document`	Fügt den angegebenen Knoten am angegebenen Index unter allen Knoten ein, die unmittelbare untergeordnete Elemente des Dokuments sind.
`cloneContent()`	`Content[]`	Erstellt nicht angehängte Kopien aller Knoten, die unmittelbare untergeordnete Elemente des Dokuments sind.
`detachRootElement()`	`Element\|null`	Trennt den `Element`-Knoten des Dokuments ab und gibt ihn zurück.
`getAllContent()`	`Content[]`	Ruft alle Knoten ab, die direkte untergeordnete Elemente des Dokuments sind.
`getContent(index)`	`Content\|null`	Ruft den Knoten am angegebenen Index unter allen Knoten ab, die unmittelbare untergeordnete Elemente des Dokuments sind.
`getContentSize()`	`Integer`	Gibt die Anzahl der Knoten zurück, die unmittelbare untergeordnete Elemente des Dokuments sind.
`getDescendants()`	`Content[]`	Ruft alle Knoten ab, die direkte oder indirekte untergeordnete Elemente des Dokuments sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`getDocType()`	`DocType\|null`	Ruft die `DocType`-Deklaration des Dokuments ab.
`getRootElement()`	`Element\|null`	Ruft den `Element`-Knoten des Stammdokuments ab.
`hasRootElement()`	`Boolean`	Ermittelt, ob das Dokument einen `Element`-Stammknoten hat.
`removeContent()`	`Content[]`	Entfernt alle Knoten, die direkte untergeordnete Elemente des Dokuments sind.
`removeContent(content)`	`Boolean`	Entfernt den angegebenen Knoten, wenn er ein direkt untergeordnetes Element des Dokuments ist.
`removeContent(index)`	`Content\|null`	Entfernt den Knoten am angegebenen Index unter allen Knoten, die unmittelbare untergeordnete Elemente des Dokuments sind.
`setDocType(docType)`	`Document`	Legt die `DocType`-Deklaration des Dokuments fest.
`setRootElement(element)`	`Document`	Legt den `Element`-Stammknoten des Dokuments fest.

`Element`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addContent(content)`	`Element`	Fügt den angegebenen Knoten als letztes untergeordnetes Element des `Element`-Knotens an.
`addContent(index, content)`	`Element`	Fügt den angegebenen Knoten am angegebenen Index zwischen allen Knoten ein, die direkte untergeordnete Elemente des `Element`-Knotens sind.
`cloneContent()`	`Content[]`	Erstellt nicht angehängte Kopien aller Knoten, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getAllContent()`	`Content[]`	Ruft alle Knoten ab, die direkte untergeordnete Elemente des {@code Element}-Knotens sind.
`getAttribute(name)`	`Attribute\|null`	Ruft das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und ohne Namespace ab.
`getAttribute(name, namespace)`	`Attribute\|null`	Ruft das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und Namespace ab.
`getAttributes()`	`Attribute[]`	Ruft alle Attribute für diesen `Element`-Knoten in der Reihenfolge ab, in der sie im Dokument angezeigt werden.
`getChild(name)`	`Element\|null`	Ruft den ersten `Element`-Knoten mit dem angegebenen Namen und ohne Namespace ab, der ein direktes untergeordnetes Element dieses `Element`-Knotens ist.
`getChild(name, namespace)`	`Element\|null`	Ruft den ersten `Element`-Knoten mit dem angegebenen Namen und Namespace ab, der ein direktes untergeordnetes Element dieses `Element`-Knotens ist.
`getChildText(name)`	`String\|null`	Ruft den Textwert des Knotens mit dem angegebenen Namen und ohne Namespace ab, wenn der Knoten ein direktes untergeordnetes Element des Knotens `Element` ist.
`getChildText(name, namespace)`	`String\|null`	Ruft den Textwert des Knotens mit dem angegebenen Namen und Namespace ab, wenn der Knoten ein direktes untergeordnetes Element des Knotens `Element` ist.
`getChildren()`	`Element[]`	Ruft alle `Element`-Knoten ab, die unmittelbare untergeordnete Elemente dieses `Element`-Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`getChildren(name)`	`Element[]`	Ruft alle `Element`-Knoten mit dem angegebenen Namen und ohne Namespace ab, die unmittelbare untergeordnete Elemente dieses `Element`-Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`getChildren(name, namespace)`	`Element[]`	Ruft alle `Element`-Knoten mit dem angegebenen Namen und Namespace ab, die unmittelbare untergeordnete Elemente dieses `Element`-Knotens sind, in der Reihenfolge, in der sie im Dokument vorkommen.
`getContent(index)`	`Content\|null`	Ruft den Knoten am angegebenen Index unter allen Knoten ab, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`getContentSize()`	`Integer`	Gibt die Anzahl der Knoten zurück, die direkte untergeordnete Elemente des {@code Element}-Knotens sind.
`getDescendants()`	`Content[]`	Ruft alle Knoten ab, die direkte oder indirekte untergeordnete Elemente des {@code Element}-Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`getDocument()`	`Document`	Gibt das XML-Dokument zurück, das den {@code Element}-Knoten enthält.
`getName()`	`String`	Ruft den lokalen Namen des `Element`-Knotens ab.
`getNamespace()`	`Namespace`	Ruft den Namespace für den Knoten `Element` ab.
`getNamespace(prefix)`	`Namespace`	Ruft den Namespace mit dem angegebenen Präfix für den `Element`-Knoten ab.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getQualifiedName()`	`String`	Ruft den lokalen Namen und das Namespace-Präfix des `Element`-Knotens im Format `[namespacePrefix]:[localName]` ab.
`getText()`	`String`	Ruft den Textwert des Knotens `Element` ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`isAncestorOf(other)`	`Boolean`	Gibt an, ob dieser `Element`-Knoten ein direktes oder indirektes übergeordnetes Element eines bestimmten `Element`-Knotens ist.
`isRootElement()`	`Boolean`	Gibt an, ob der Knoten `Element` der Stammknoten des Dokuments ist.
`removeAttribute(attribute)`	`Boolean`	Entfernt das angegebene Attribut für diesen `Element`-Knoten, sofern ein solches Attribut vorhanden ist.
`removeAttribute(attributeName)`	`Boolean`	Entfernt das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und ohne Namespace, falls ein solches Attribut vorhanden ist.
`removeAttribute(attributeName, namespace)`	`Boolean`	Entfernt das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und Namespace, falls ein solches Attribut vorhanden ist.
`removeContent()`	`Content[]`	Entfernt alle Knoten, die direkte untergeordnete Elemente des {@code Element}-Knotens sind.
`removeContent(content)`	`Boolean`	Entfernt den angegebenen Knoten, wenn er ein direkt untergeordnetes Element des {@code Element}-Knotens ist.
`removeContent(index)`	`Content\|null`	Entfernt den Knoten am angegebenen Index unter allen Knoten, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`setAttribute(attribute)`	`Element`	Legt das angegebene Attribut für diesen `Element`-Knoten fest.
`setAttribute(name, value)`	`Element`	Legt das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und Wert und ohne Namespace fest.
`setAttribute(name, value, namespace)`	`Element`	Legt das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen, Wert und Namespace fest.
`setName(name)`	`Element`	Legt den lokalen Namen des `Element`-Knotens fest.
`setNamespace(namespace)`	`Element`	Legt den Namespace für den Knoten `Element` fest.
`setText(text)`	`Element`	Legt den Textwert des Knotens `Element` fest.

`EntityRef`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getName()`	`String`	Ruft den Namen des `EntityReference`-Knotens ab.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getPublicId()`	`String\|null`	Ruft die öffentliche ID des `EntityReference`-Knotens ab.
`getSystemId()`	`String\|null`	Ruft die System-ID des `EntityReference`-Knotens ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`setName(name)`	`EntityRef`	Legt den Namen des `EntityReference`-Knotens fest.
`setPublicId(id)`	`EntityRef`	Legt die öffentliche ID des `EntityReference`-Knotens fest.
`setSystemId(id)`	`EntityRef`	Legt die System-ID des `EntityReference`-Knotens fest.

`Format`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`format(document)`	`String`	Gibt die angegebene `Document` als formatierten String aus.
`format(element)`	`String`	Gibt den angegebenen `Element`-Knoten als formatierten String aus.
`setEncoding(encoding)`	`Format`	Legt die Zeichencodierung fest, die vom Formatierungsprogramm verwendet werden soll.
`setIndent(indent)`	`Format`	Legt den String fest, der zum Einrücken von untergeordneten Knoten relativ zu ihren übergeordneten Knoten verwendet wird.
`setLineSeparator(separator)`	`Format`	Legt den String fest, der eingefügt werden soll, wenn der Formatierer normalerweise einen Zeilenumbruch einfügen würde.
`setOmitDeclaration(omitDeclaration)`	`Format`	Legt fest, ob der Formatierer die XML-Deklaration wie `<?xml version="1.0" encoding="UTF-8"?>` weglassen soll.
`setOmitEncoding(omitEncoding)`	`Format`	Legt fest, ob der Formatierer die Codierung in der XML-Deklaration weglassen soll, z. B. das Codierungsfeld in `<?xml version="1.0" encoding="UTF-8"?>`.

`Namespace`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getPrefix()`	`String`	Ruft das Präfix für den Namespace ab.
`getURI()`	`String`	Ruft den URI für den Namespace ab.

`ProcessingInstruction`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getData()`	`String`	Ruft die Rohdaten für jede Anleitung im `ProcessingInstruction`-Knoten ab.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getTarget()`	`String`	Ruft das Ziel für den Knoten `ProcessingInstruction` ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.

`Text`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`append(text)`	`Text`	Hängt den angegebenen Text an alle Inhalte an, die bereits im Knoten vorhanden sind.
`detach()`	`Content\|null`	Trennt den Knoten vom übergeordneten Knoten `Element`.
`getParentElement()`	`Element\|null`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getText()`	`String`	Ruft den Textwert des Knotens `Text` ab.
`getValue()`	`String`	Ruft den Textwert aller Knoten ab, die direkte oder indirekte untergeordnete Elemente des Knotens sind, in der Reihenfolge, in der sie im Dokument angezeigt werden.
`setText(text)`	`Text`	Legt den Textwert des Knotens `Text` fest.

`XmlService`

Attribute

Attribut	Typ	Beschreibung
`ContentTypes`	`ContentType`	Eine Aufzählung, die die Typen von XML-Inhaltsknoten darstellt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createCdata(text)`	`Cdata`	Erstellt einen nicht angehängten `CDATASection`-Knoten mit dem angegebenen Wert.
`createComment(text)`	`Comment`	Erstellt einen nicht angehängten `Comment`-Knoten mit dem angegebenen Wert.
`createDocType(elementName)`	`DocType`	Erstellt einen nicht angehängten `DocumentType`-Knoten für den Root-Knoten `Element` mit dem angegebenen Namen.
`createDocType(elementName, systemId)`	`DocType`	Erstellt einen nicht angehängten `DocumentType`-Knoten für den Root-`Element`-Knoten mit dem angegebenen Namen und der angegebenen System-ID für die externen Subset-Daten.
`createDocType(elementName, publicId, systemId)`	`DocType`	Erstellt einen nicht angehängten `DocumentType`-Knoten für den `Element`-Root-Knoten mit dem angegebenen Namen sowie der angegebenen öffentlichen ID und System-ID für die externen Subset-Daten.
`createDocument()`	`Document`	Erstellt ein leeres XML-Dokument.
`createDocument(rootElement)`	`Document`	Erstellt ein XML-Dokument mit dem angegebenen `Element`-Stammknoten.
`createElement(name)`	`Element`	Erstellt einen nicht angehängten `Element`-Knoten mit dem angegebenen lokalen Namen und ohne Namespace.
`createElement(name, namespace)`	`Element`	Erstellt einen nicht angehängten `Element`-Knoten mit dem angegebenen lokalen Namen und Namespace.
`createText(text)`	`Text`	Erstellt einen nicht angehängten `Text`-Knoten mit dem angegebenen Wert.
`getCompactFormat()`	`Format`	Erstellt ein `Format`-Objekt für die Ausgabe eines kompakten XML-Dokuments.
`getNamespace(uri)`	`Namespace`	Erstellt ein `Namespace`-Objekt mit dem angegebenen URI.
`getNamespace(prefix, uri)`	`Namespace`	Erstellt ein `Namespace`-Objekt mit dem angegebenen Präfix und URI.
`getNoNamespace()`	`Namespace`	Erstellt ein `Namespace`, das das Fehlen eines echten Namespace darstellt.
`getPrettyFormat()`	`Format`	Erstellt ein `Format`-Objekt zum Ausgeben eines für Menschen lesbaren XML-Dokuments.
`getRawFormat()`	`Format`	Erstellt ein `Format`-Objekt für die Ausgabe eines Roh-XML-Dokuments.
`getXmlNamespace()`	`Namespace`	Erstellt ein `Namespace` mit dem Standardpräfix `xml`.
`parse(xml)`	`Document`	Erstellt ein `Document`-Objekt aus dem angegebenen XML-Code, ohne den XML-Code zu validieren.

XML Service Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Klassen

Methoden

Methoden

Methoden

Methoden

Attribute

Methoden

Methoden

Methoden

Methoden

Methoden

Methoden

Methoden

Methoden

Attribute

Methoden

XML Service