Ta strona została przetłumaczona przez Cloud Translation API.

XML Service

Ta usługa umożliwia skryptom analizowanie, nawigowanie i tworzenie programowo dokumentów XML.

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

Zajęcia

Nazwa	Krótki opis
`Attribute`	Reprezentacja atrybutu XML.
`Cdata`	Węzeł XML `CDATASection`.
`Comment`	Węzeł XML `Comment`.
`Content`	Ogólny węzeł XML.
`ContentType`	Wyliczenie reprezentujące typy węzłów treści XML.
`DocType`	Węzeł XML `DocumentType`.
`Document`	Reprezentacja dokumentu XML.
`Element`	Węzeł XML `Element`.
`EntityRef`	Węzeł XML `EntityReference`.
`Format`	Formatowanie służące do wyprowadzania dokumentu XML. Dostępne są 3 wstępnie zdefiniowane formaty, które można dodatkowo dostosować.
`Namespace`	Reprezentacja przestrzeni nazw XML.
`ProcessingInstruction`	Węzeł XML `ProcessingInstruction`.
`Text`	Węzeł XML `Text`.
`XmlService`	Ta usługa umożliwia skryptom analizowanie, nawigowanie i tworzenie dokumentów XML w ramach programowania.

`Attribute`

Metody

Metoda	Zwracany typ	Krótki opis
`getName()`	`String`	Pobiera lokalną nazwę atrybutu.
`getNamespace()`	`Namespace`	Pobiera nazwę przestrzeni nazw atrybutu.
`getValue()`	`String`	Pobiera wartość atrybutu.
`setName(name)`	`Attribute`	Ustawia lokalną nazwę atrybutu.
`setNamespace(namespace)`	`Attribute`	Ustawia przestrzeń nazw dla atrybutu.
`setValue(value)`	`Attribute`	Ustawia wartość atrybutu.

`Cdata`

Metody

Metoda	Zwracany typ	Krótki opis
`append(text)`	`Text`	Dodaje podany tekst do treści, które już istnieją w węźle.
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getText()`	`String`	Pobiera wartość tekstową węzła `Text`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.
`setText(text)`	`Text`	Ustawia wartość tekstową węzła `Text`.

`Comment`

Metody

Metoda	Zwracany typ	Krótki opis
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getText()`	`String`	Pobiera wartość tekstową węzła `Comment`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.
`setText(text)`	`Comment`	Ustawia wartość tekstową węzła `Comment`.

`Content`

Metody

Metoda	Zwracany typ	Krótki opis
`asCdata()`	`Cdata`	Przekształca węzeł w węzeł `CDATASection` na potrzeby autouzupełniania.
`asComment()`	`Comment`	Przekształca węzeł w węzeł `Comment` na potrzeby autouzupełniania.
`asDocType()`	`DocType`	Przekształca węzeł w węzeł `DocumentType` na potrzeby autouzupełniania.
`asElement()`	`Element`	Przekształca węzeł w węzeł `Element` na potrzeby autouzupełniania.
`asEntityRef()`	`EntityRef`	Przekształca węzeł w węzeł `EntityReference` na potrzeby autouzupełniania.
`asProcessingInstruction()`	`ProcessingInstruction`	Przekształca węzeł w węzeł `ProcessingInstruction` na potrzeby autouzupełniania.
`asText()`	`Text`	Przekształca węzeł w węzeł `Text` na potrzeby autouzupełniania.
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getType()`	`ContentType`	Pobiera typ treści węzła.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.

`ContentType`

Właściwości

Właściwość	Typ	Opis
`CDATA`	`Enum`	Węzeł XML `CDATASection`.
`COMMENT`	`Enum`	Węzeł XML `Comment`.
`DOCTYPE`	`Enum`	Węzeł XML `DocumentType`.
`ELEMENT`	`Enum`	Węzeł XML `Element`.
`ENTITYREF`	`Enum`	Węzeł XML `EntityReference`.
`PROCESSINGINSTRUCTION`	`Enum`	Węzeł XML `ProcessingInstruction`.
`TEXT`	`Enum`	Węzeł XML `Text`.

`DocType`

Metody

Metoda	Zwracany typ	Krótki opis
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getElementName()`	`String`	Pobiera nazwę wierzchołka `Element` głównego określonego w deklaracji `DocType`.
`getInternalSubset()`	`String`	Pobiera dane wewnętrznego podzbioru węzła `DocumentType`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getPublicId()`	`String`	Pobiera publiczny identyfikator zewnętrznych danych podzbioru dla węzła `DocumentType`.
`getSystemId()`	`String`	Pobiera identyfikator systemu danych zewnętrznych podzbioru dla węzła `DocumentType`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.
`setElementName(name)`	`DocType`	Ustawia nazwę węzła `Element`, który ma być podany w deklaracji `DocType`.
`setInternalSubset(data)`	`DocType`	Ustawia dane wewnętrznego podzbioru dla węzła `DocumentType`.
`setPublicId(id)`	`DocType`	Ustawia publiczny identyfikator zewnętrznego podzbioru danych dla węzła `DocumentType`.
`setSystemId(id)`	`DocType`	Ustawia identyfikator systemu danych zewnętrznych podzbioru dla węzła `DocumentType`.

`Document`

Metody

Metoda	Zwracany typ	Krótki opis
`addContent(content)`	`Document`	Dodaje podany węzeł na końcu dokumentu.
`addContent(index, content)`	`Document`	Wstawia dany węzeł pod podanym indeksem wśród wszystkich węzłów, które są bezpośrednimi podrzędnymi dokumentu.
`cloneContent()`	`Content[]`	Tworzy kopie wszystkich nieprzypisanych węzłów, które są bezpośrednimi podrzędnymi dokumentu.
`detachRootElement()`	`Element`	Odłącza i zwraca węzeł główny `Element` dokumentu.
`getAllContent()`	`Content[]`	Pobiera wszystkie węzły, które są bezpośrednimi podrzędnymi dokumentu.
`getContent(index)`	`Content`	Pobiera węzeł o danym indeksie spośród wszystkich węzłów, które są bezpośrednimi podrzędnymi dokumentu.
`getContentSize()`	`Integer`	Pobiera liczbę węzłów, które są bezpośrednimi podrzędnymi dokumentu.
`getDescendants()`	`Content[]`	Pobiera wszystkie węzły, które są bezpośrednimi lub pośrednimi elementami podrzędnymi dokumentu, w kolejności, w jakiej występują w dokumencie.
`getDocType()`	`DocType`	Pobiera deklarację `DocType` dokumentu.
`getRootElement()`	`Element`	Pobiera główny `Element` węzeł dokumentu.
`hasRootElement()`	`Boolean`	Określa, czy dokument ma węzeł główny `Element`.
`removeContent()`	`Content[]`	Usuwa wszystkie węzły, które są bezpośrednimi podrzędnymi dokumentu.
`removeContent(content)`	`Boolean`	Usuwa podany węzeł, jeśli jest on bezpośrednio podrzędnym węzłem dokumentu.
`removeContent(index)`	`Content`	Usuwa węzeł o danym indeksie spośród wszystkich węzłów, które są bezpośrednimi podrzędnymi dokumentu.
`setDocType(docType)`	`Document`	Ustawia deklarację `DocType` dokumentu.
`setRootElement(element)`	`Document`	Ustawia `Element`, czyli wierzchołek dokumentu.

`Element`

Metody

Metoda	Zwracany typ	Krótki opis
`addContent(content)`	`Element`	Dodaje podany węzeł jako ostatni element podrzędny węzła `Element`.
`addContent(index, content)`	`Element`	Wstawia dany węzeł pod podanym indeksem wśród wszystkich węzłów, które są bezpośrednimi podrzędnymi węzła `Element`.
`cloneContent()`	`Content[]`	Tworzy niezałączone kopie wszystkich węzłów, które są bezpośrednimi podrzędnymi węzła {@code Element}.
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getAllContent()`	`Content[]`	Pobiera wszystkie węzły, które są bezpośrednimi podrzędnymi węzła {@code Element}.
`getAttribute(name)`	`Attribute`	Pobiera atrybut węzła `Element` o podanej nazwie bez podawania przestrzeni nazw.
`getAttribute(name, namespace)`	`Attribute`	Pobiera atrybut węzła `Element` o podanej nazwie i przestrzeni nazw.
`getAttributes()`	`Attribute[]`	Pobiera wszystkie atrybuty węzła `Element` w kolejności, w jakiej występują w dokumencie.
`getChild(name)`	`Element`	Pobiera pierwszy węzeł `Element` o podanej nazwie i bez przestrzeni nazw, który jest bezpośrednim podrzędnym węzłem tego węzła `Element`.
`getChild(name, namespace)`	`Element`	Pobiera pierwszy węzeł `Element` o podanej nazwie i przestrzeni nazw, który jest bezpośrednim podrzędnym węzłem tego węzła `Element`.
`getChildText(name)`	`String`	Pobiera wartość tekstową węzła o danej nazwie i bez przestrzeni nazw, jeśli węzeł jest węzłem bezpośrednim węzła `Element`.
`getChildText(name, namespace)`	`String`	Pobiera wartość tekstową węzła o podanej nazwie i przestrzeni nazw, jeśli węzeł jest bezpośrednim podrzędnym węzła `Element`.
`getChildren()`	`Element[]`	Pobiera wszystkie węzły `Element`, które są bezpośrednimi podrzędnymi węzła `Element`, w kolejności, w jakiej występują w dokumencie.
`getChildren(name)`	`Element[]`	Pobiera wszystkie węzły `Element` o podanej nazwie i bez przestrzeni nazw, które są bezpośrednimi podrzędnymi węzła `Element`, w kolejności ich występowania w dokumencie.
`getChildren(name, namespace)`	`Element[]`	Pobiera wszystkie węzły `Element` o danej nazwie i w danej przestrzeni nazw, które są bezpośrednimi podrzędnymi węzła `Element`, w kolejności, w jakiej występują w dokumencie.
`getContent(index)`	`Content`	Pobiera węzeł o danym indeksie spośród wszystkich węzłów, które są bezpośrednimi podrzędnymi węzła {@code Element}.
`getContentSize()`	`Integer`	Pobiera liczbę węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}.
`getDescendants()`	`Content[]`	Pobiera wszystkie węzły, które są bezpośrednimi lub pośrednimi podrzędnymi węzła {@code Element}, w kolejności, w jakiej występują w dokumencie.
`getDocument()`	`Document`	Pobiera dokument XML zawierający węzeł {@code Element}.
`getName()`	`String`	Pobiera lokalną nazwę węzła `Element`.
`getNamespace()`	`Namespace`	Pobiera nazwę przestrzeni nazw węzła `Element`.
`getNamespace(prefix)`	`Namespace`	Pobiera przestrzeń nazw z danym prefiksem dla węzła `Element`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getQualifiedName()`	`String`	Pobiera nazwę lokalną i prefiks przestrzeni nazw węzła `Element` w formacie `[namespacePrefix]:[localName]`.
`getText()`	`String`	Pobiera wartość tekstową węzła `Element`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.
`isAncestorOf(other)`	`Boolean`	Określa, czy ten węzeł `Element` jest węzłem nadrzędnym bezpośrednim czy pośrednim danego węzła `Element`.
`isRootElement()`	`Boolean`	Określa, czy węzeł `Element` jest węzłem głównym dokumentu.
`removeAttribute(attribute)`	`Boolean`	Usuwa dany atrybut z tego węzła `Element`, jeśli taki atrybut istnieje.
`removeAttribute(attributeName)`	`Boolean`	Usuwa atrybut tego węzła `Element` o danej nazwie i bez przestrzeni nazw, jeśli taki atrybut istnieje.
`removeAttribute(attributeName, namespace)`	`Boolean`	Usuwa atrybut tego węzła `Element` o danej nazwie i w danej przestrzeni nazw, jeśli taki atrybut istnieje.
`removeContent()`	`Content[]`	Usuwa wszystkie węzły, które są bezpośrednimi podrzędnymi węzła {@code Element}.
`removeContent(content)`	`Boolean`	Usuwa podany węzeł, jeśli jest on bezpośrednim podrzędnym węzła {@code Element}.
`removeContent(index)`	`Content`	Usuwa węzeł o danym indeksie spośród wszystkich węzłów, które są bezpośrednimi podrzędnymi węzła {@code Element}.
`setAttribute(attribute)`	`Element`	Ustawia podany atrybut dla tego węzła `Element`.
`setAttribute(name, value)`	`Element`	Ustawia atrybut tego węzła `Element` z podaną nazwą, wartością i bez przestrzeni nazw.
`setAttribute(name, value, namespace)`	`Element`	Ustawia atrybut tego węzła `Element` z podaną nazwą, wartością i przestrzenią nazw.
`setName(name)`	`Element`	Ustawia lokalną nazwę węzła `Element`.
`setNamespace(namespace)`	`Element`	Ustawia przestrzeń nazw dla węzła `Element`.
`setText(text)`	`Element`	Ustawia wartość tekstową węzła `Element`.

`EntityRef`

Metody

Metoda	Zwracany typ	Krótki opis
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getName()`	`String`	Pobiera nazwę węzła `EntityReference`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getPublicId()`	`String`	Pobiera publiczny identyfikator węzła `EntityReference`.
`getSystemId()`	`String`	Pobiera identyfikator systemu węzła `EntityReference`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.
`setName(name)`	`EntityRef`	Ustawia nazwę węzła `EntityReference`.
`setPublicId(id)`	`EntityRef`	Ustawia publiczny identyfikator węzła `EntityReference`.
`setSystemId(id)`	`EntityRef`	Ustawia identyfikator systemu węzła `EntityReference`.

`Format`

Metody

Metoda	Zwracany typ	Krótki opis
`format(document)`	`String`	Wypisuje podany parametr `Document` jako sformatowany ciąg znaków.
`format(element)`	`String`	Wypisuje podany węzeł `Element` jako sformatowany ciąg znaków.
`setEncoding(encoding)`	`Format`	Określa kodowanie znaków, którego ma używać formatowanie.
`setIndent(indent)`	`Format`	Ustawia ciąg znaków używany do wcięcia węzłów podrzędnych względem ich węzłów nadrzędnych.
`setLineSeparator(separator)`	`Format`	Ustawia ciąg znaków do wstawienia, gdy formatowanie normalnie wstawia podział wiersza.
`setOmitDeclaration(omitDeclaration)`	`Format`	Określa, czy formatowanie powinno pomijać deklarację XML, np. `<?xml version="1.0" encoding="UTF-8"?>`.
`setOmitEncoding(omitEncoding)`	`Format`	Określa, czy formater powinien pominąć kodowanie w deklaracji XML, np. pole kodowania w `<?xml version="1.0" encoding="UTF-8"?>`.

`Namespace`

Metody

Metoda	Zwracany typ	Krótki opis
`getPrefix()`	`String`	Pobiera prefiks przestrzeni nazw.
`getURI()`	`String`	Pobiera identyfikator URI przestrzeni nazw.

`ProcessingInstruction`

Metody

Metoda	Zwracany typ	Krótki opis
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getData()`	`String`	Pobiera nieprzetworzone dane dotyczące każdej instrukcji w węźle `ProcessingInstruction`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getTarget()`	`String`	Pobiera wartość docelową węzła `ProcessingInstruction`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.

`Text`

Metody

Metoda	Zwracany typ	Krótki opis
`append(text)`	`Text`	Dodaje podany tekst do treści, które już istnieją w węźle.
`detach()`	`Content`	Odłącza węzeł od nadrzędnego węzła `Element`.
`getParentElement()`	`Element`	Pobiera węzeł nadrzędny `Element` węzła.
`getText()`	`String`	Pobiera wartość tekstową węzła `Text`.
`getValue()`	`String`	Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie.
`setText(text)`	`Text`	Ustawia wartość tekstową węzła `Text`.

`XmlService`

Właściwości

Właściwość	Typ	Opis
`ContentTypes`	`ContentType`	Wyliczenie reprezentujące typy węzłów treści XML.

Metody

Metoda	Zwracany typ	Krótki opis
`createCdata(text)`	`Cdata`	Tworzy niepowiązany węzeł `CDATASection` z określoną wartością.
`createComment(text)`	`Comment`	Tworzy niepowiązany węzeł `Comment` z określoną wartością.
`createDocType(elementName)`	`DocType`	Tworzy niepowiązany węzeł `DocumentType` dla węzła głównego `Element` o podanej nazwie.
`createDocType(elementName, systemId)`	`DocType`	Tworzy niepowiązany węzeł `DocumentType` dla węzła `Element` z daną nazwą i danym identyfikatorem systemowym dla danych zewnętrznych podzbioru.
`createDocType(elementName, publicId, systemId)`	`DocType`	Tworzy nieprzyłączony węzeł `DocumentType` dla węzła `Element` z podaną nazwą oraz podanym identyfikatorem publicznym i identyfikatorem systemowym dla danych zewnętrznych podzbioru.
`createDocument()`	`Document`	Tworzy pusty dokument XML.
`createDocument(rootElement)`	`Document`	Tworzy dokument XML z danym węzłem głównym `Element`.
`createElement(name)`	`Element`	Tworzy niepowiązany węzeł `Element` o podanej nazwie lokalnej i bez przestrzeni nazw.
`createElement(name, namespace)`	`Element`	Tworzy niepowiązany węzeł `Element` z daną nazwą lokalną i przestrzenią nazw.
`createText(text)`	`Text`	Tworzy niepowiązany węzeł `Text` z określoną wartością.
`getCompactFormat()`	`Format`	Tworzy obiekt `Format`, aby wygenerować skompresowany dokument XML.
`getNamespace(uri)`	`Namespace`	Tworzy obiekt `Namespace` z podanym identyfikatorem URI.
`getNamespace(prefix, uri)`	`Namespace`	Tworzy `Namespace` z danym prefiksem i identyfikatorem URI.
`getNoNamespace()`	`Namespace`	Tworzy `Namespace`, który reprezentuje brak prawdziwej przestrzeni nazw.
`getPrettyFormat()`	`Format`	Tworzy obiekt `Format`, aby wygenerować czytelny dla człowieka dokument XML.
`getRawFormat()`	`Format`	Tworzy obiekt `Format`, aby wygenerować surowy dokument XML.
`getXmlNamespace()`	`Namespace`	Tworzy `Namespace` ze standardowym prefiksem `xml`.
`parse(xml)`	`Document`	Tworzy `Document` z podanego kodu XML bez jego weryfikacji.