Diese Seite wurde von der Cloud Translation API übersetzt.

XML Service

Mit diesem Dienst können Scripts XML-Dokumente parsen, durchsuchen und 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);
}

Classes

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 zum Ausgeben eines XML-Dokuments mit drei vordefinierten Formaten, die weiter angepasst werden können.
`Namespace`	Eine Darstellung eines XML-Namespaces.
`ProcessingInstruction`	Eine Darstellung eines XML-`ProcessingInstruction`-Knotens.
`Text`	Eine Darstellung eines XML-`Text`-Knotens.
`XmlService`	Mit diesem Dienst können Scripts XML-Dokumente parsen, durchsuchen und programmatisch erstellen.

`Attribute`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getName()`	`String`	Der lokale Name des Attributs.
`getNamespace()`	`Namespace`	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`	Der angegebene Text wird an alle Inhalte angehängt, die bereits im Knoten vorhanden sind.
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getParentElement()`	`Element`	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 erscheinen.
`setText(text)`	`Text`	Legt den Textwert des Knotens `Text` fest.

`Comment`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getParentElement()`	`Element`	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 erscheinen.
`setText(text)`	`Comment`	Legt den Textwert des Knotens `Comment` fest.

`Content`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`asCdata()`	`Cdata`	Der Knoten wird für die automatische Vervollständigung als `CDATASection`-Knoten gecastet.
`asComment()`	`Comment`	Der Knoten wird für die automatische Vervollständigung als `Comment`-Knoten gecastet.
`asDocType()`	`DocType`	Der Knoten wird für die automatische Vervollständigung als `DocumentType`-Knoten gecastet.
`asElement()`	`Element`	Der Knoten wird für die automatische Vervollständigung als `Element`-Knoten gecastet.
`asEntityRef()`	`EntityRef`	Der Knoten wird für die automatische Vervollständigung als `EntityReference`-Knoten gecastet.
`asProcessingInstruction()`	`ProcessingInstruction`	Der Knoten wird für die automatische Vervollständigung als `ProcessingInstruction`-Knoten gecastet.
`asText()`	`Text`	Der Knoten wird für die automatische Vervollständigung als `Text`-Knoten gecastet.
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getParentElement()`	`Element`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getType()`	`ContentType`	Der Inhaltstyp des Knotens.
`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 erscheinen.

`ContentType`

Attribute

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

`DocType`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getElementName()`	`String`	Ruft den Namen des Stammknotens `Element` ab, der in der `DocType`-Deklaration angegeben ist.
`getInternalSubset()`	`String`	Ruft die internen Teilmengendaten für den Knoten `DocumentType` ab.
`getParentElement()`	`Element`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getPublicId()`	`String`	Ruft die öffentliche ID der externen Teilmenge 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 erscheinen.
`setElementName(name)`	`DocType`	Legt den Namen des Stammknotens `Element` fest, der in der `DocType`-Deklaration angegeben werden soll.
`setInternalSubset(data)`	`DocType`	Hiermit werden die internen Teilmengendaten für den `DocumentType`-Knoten festgelegt.
`setPublicId(id)`	`DocType`	Legt die öffentliche ID der externen Teilmenge für den `DocumentType`-Knoten 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 an das Ende des Dokuments an.
`addContent(index, content)`	`Document`	Der angegebene Knoten wird an der angegebenen Position unter allen Knoten eingefügt, die unmittelbare untergeordnete Elemente des Dokuments sind.
`cloneContent()`	`Content[]`	Es werden losgelöste Kopien aller Knoten erstellt, die unmittelbare untergeordnete Elemente des Dokuments sind.
`detachRootElement()`	`Element`	Trennt den Stammknoten `Element` des Dokuments und gibt ihn zurück.
`getAllContent()`	`Content[]`	Alle Knoten abrufen, die dem Dokument direkt untergeordnet sind.
`getContent(index)`	`Content`	Ruft den Knoten mit dem angegebenen Index unter allen Knoten ab, die unmittelbare untergeordnete Elemente des Dokuments sind.
`getContentSize()`	`Integer`	Die Anzahl der Knoten, die unmittelbare untergeordnete Elemente des Dokuments sind.
`getDescendants()`	`Content[]`	Hier werden alle Knoten abgerufen, die direkte oder indirekte untergeordnete Elemente des Dokuments sind, in der Reihenfolge, in der sie im Dokument erscheinen.
`getDocType()`	`DocType`	Ruft die `DocType`-Erklärung des Dokuments ab.
`getRootElement()`	`Element`	Ruft den Stammknoten `Element` des Dokuments ab.
`hasRootElement()`	`Boolean`	Bestimmt, ob das Dokument einen Stammknoten `Element` hat.
`removeContent()`	`Content[]`	Entfernt alle Knoten, die unmittelbare untergeordnete Elemente des Dokuments sind.
`removeContent(content)`	`Boolean`	Entfernt den angegebenen Knoten, wenn er ein direktes untergeordnetes Element des Dokuments ist.
`removeContent(index)`	`Content`	Entfernt den Knoten mit dem angegebenen Index aus allen Knoten, die unmittelbare untergeordnete Elemente des Dokuments sind.
`setDocType(docType)`	`Document`	Legt die `DocType`-Erklärung des Dokuments fest.
`setRootElement(element)`	`Document`	Legt den Stamm-`Element`-Knoten des Dokuments fest.

`Element`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addContent(content)`	`Element`	Der angegebene Knoten wird als letztes untergeordnetes Element des `Element`-Knotens angehängt.
`addContent(index, content)`	`Element`	Der angegebene Knoten wird an der angegebenen Position unter allen Knoten eingefügt, die unmittelbare untergeordnete Knoten des Knotens `Element` sind.
`cloneContent()`	`Content[]`	Es werden losgelöste Kopien aller Knoten erstellt, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getAllContent()`	`Content[]`	Hiermit werden alle Knoten abgerufen, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`getAttribute(name)`	`Attribute`	Ruft das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und ohne Namespace ab.
`getAttribute(name, namespace)`	`Attribute`	Ruft das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen und Namespace ab.
`getAttributes()`	`Attribute[]`	Hier werden alle Attribute für diesen `Element`-Knoten in der Reihenfolge abgerufen, in der sie im Dokument erscheinen.
`getChild(name)`	`Element`	Ruft den ersten `Element`-Knoten mit dem angegebenen Namen und ohne Namespace ab, der ein direktes Kind dieses `Element`-Knotens ist.
`getChild(name, namespace)`	`Element`	Ruft den ersten `Element`-Knoten mit dem angegebenen Namen und Namespace ab, der ein direktes Kind dieses `Element`-Knotens ist.
`getChildText(name)`	`String`	Ruft den Textwert des Knotens mit dem angegebenen Namen und ohne Namespace ab, wenn der Knoten ein direktes Kind des Knotens `Element` ist.
`getChildText(name, namespace)`	`String`	Ruft den Textwert des Knotens mit dem angegebenen Namen und Namespace ab, wenn der Knoten ein direktes Kind 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 erscheinen.
`getChildren(name)`	`Element[]`	Hiermit werden alle `Element`-Knoten mit dem angegebenen Namen und ohne Namespace abgerufen, die unmittelbare Unterknoten dieses `Element`-Knotens sind. Die Knoten werden in der Reihenfolge abgerufen, in der sie im Dokument vorkommen.
`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 erscheinen.
`getContent(index)`	`Content`	Ruft den Knoten mit dem angegebenen Index aus allen Knoten ab, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`getContentSize()`	`Integer`	Die Anzahl der Knoten, die unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`getDescendants()`	`Content[]`	Hier werden alle Knoten abgerufen, die direkte oder indirekte untergeordnete Elemente des {@code Element}-Knotens sind, in der Reihenfolge, in der sie im Dokument erscheinen.
`getDocument()`	`Document`	Ruft das XML-Dokument ab, das den Knoten {@code Element} enthält.
`getName()`	`String`	Der lokale Name des `Element`-Knotens.
`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`	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 erscheinen.
`isAncestorOf(other)`	`Boolean`	Bestimmt, ob dieser `Element`-Knoten ein direkter oder indirekter übergeordneter Knoten eines bestimmten `Element`-Knotens ist.
`isRootElement()`	`Boolean`	Bestimmt, ob der `Element`-Knoten der Stammknoten des Dokuments ist.
`removeAttribute(attribute)`	`Boolean`	Entfernt das angegebene Attribut für diesen `Element`-Knoten, sofern vorhanden.
`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 unmittelbare untergeordnete Elemente des {@code Element}-Knotens sind.
`removeContent(content)`	`Boolean`	Entfernt den angegebenen Knoten, wenn er ein direktes untergeordnetes Element des {@code Element}-Knotens ist.
`removeContent(index)`	`Content`	Entfernt den Knoten am angegebenen Index aus allen Knoten, die unmittelbare untergeordnete Elemente des Knotens {@code Element} sind.
`setAttribute(attribute)`	`Element`	Legt das angegebene Attribut für diesen `Element`-Knoten fest.
`setAttribute(name, value)`	`Element`	Hiermit wird das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen, Wert und ohne Namespace festgelegt.
`setAttribute(name, value, namespace)`	`Element`	Hiermit wird das Attribut für diesen `Element`-Knoten mit dem angegebenen Namen, Wert und Namespace festgelegt.
`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`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getName()`	`String`	Ruft den Namen des `EntityReference`-Knotens ab.
`getParentElement()`	`Element`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getPublicId()`	`String`	Ruft die öffentliche ID des `EntityReference`-Knotens ab.
`getSystemId()`	`String`	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 erscheinen.
`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 der Formatierer verwenden soll.
`setIndent(indent)`	`Format`	Hiermit wird der String festgelegt, mit dem untergeordnete Knoten relativ zu ihren übergeordneten Elementen eingerückt werden.
`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 auslassen soll, z. B. `<?xml version="1.0" encoding="UTF-8"?>`.
`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`	Das Präfix für den Namespace.
`getURI()`	`String`	Ruft den URI für den Namespace ab.

`ProcessingInstruction`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getData()`	`String`	Hier werden die Rohdaten für jede Anweisung im `ProcessingInstruction`-Knoten abgerufen.
`getParentElement()`	`Element`	Ruft den übergeordneten `Element`-Knoten des Knotens ab.
`getTarget()`	`String`	Ruft das Ziel für den `ProcessingInstruction`-Knoten 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 erscheinen.

`Text`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`append(text)`	`Text`	Der angegebene Text wird an alle Inhalte angehängt, die bereits im Knoten vorhanden sind.
`detach()`	`Content`	Der Knoten wird von seinem übergeordneten Knoten `Element` getrennt.
`getParentElement()`	`Element`	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 erscheinen.
`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 losgelösten `CDATASection`-Knoten mit dem angegebenen Wert.
`createComment(text)`	`Comment`	Erstellt einen losgelösten `Comment`-Knoten mit dem angegebenen Wert.
`createDocType(elementName)`	`DocType`	Erstellt einen losgelösten `DocumentType`-Knoten für den Stammknoten `Element` mit dem angegebenen Namen.
`createDocType(elementName, systemId)`	`DocType`	Erstellt einen losgelösten `DocumentType`-Knoten für den Stammknoten `Element` mit dem angegebenen Namen und der angegebenen System-ID für die externen Teilmengendaten.
`createDocType(elementName, publicId, systemId)`	`DocType`	Erstellt einen losgelösten `DocumentType`-Knoten für den Stammknoten `Element` mit dem angegebenen Namen sowie der angegebenen öffentlichen ID und System-ID für die externen Teilmengendaten.
`createDocument()`	`Document`	Erstellt ein leeres XML-Dokument.
`createDocument(rootElement)`	`Document`	Erstellt ein XML-Dokument mit dem angegebenen Stammknoten `Element`.
`createElement(name)`	`Element`	Erstellt einen losgelösten `Element`-Knoten mit dem angegebenen lokalen Namen und ohne Namespace.
`createElement(name, namespace)`	`Element`	Erstellt einen losgelösten `Element`-Knoten mit dem angegebenen lokalen Namen und Namespace.
`createText(text)`	`Text`	Erstellt einen losgelösten `Text`-Knoten mit dem angegebenen Wert.
`getCompactFormat()`	`Format`	Erstellt ein `Format`-Objekt für die Ausgabe eines kompakten XML-Dokuments.
`getNamespace(uri)`	`Namespace`	Erstellt eine `Namespace` mit dem angegebenen URI.
`getNamespace(prefix, uri)`	`Namespace`	Erstellt eine `Namespace` mit dem angegebenen Präfix und URI.
`getNoNamespace()`	`Namespace`	Erstellt einen `Namespace`, der das Fehlen eines echten Namespace darstellt.
`getPrettyFormat()`	`Format`	Erstellt ein `Format`-Objekt für die Ausgabe eines visuell lesbaren XML-Dokuments.
`getRawFormat()`	`Format`	Erstellt ein `Format`-Objekt für die Ausgabe eines Roh-XML-Dokuments.
`getXmlNamespace()`	`Namespace`	Erstellt eine `Namespace` mit dem Standardpräfix `xml`.
`parse(xml)`	`Document`	Erstellt eine `Document` aus der angegebenen XML-Datei, ohne die XML-Datei zu validieren.