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. |
Content | Wyliczenie reprezentujące typy węzłów treści XML. |
Doc | Węzeł XML Document. |
Document | Reprezentacja dokumentu XML. |
Element | Węzeł XML Element. |
Entity | Węzeł XML Entity. |
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. |
Processing | Węzeł XML Processing. |
Text | Węzeł XML Text. |
Xml | Ta usługa umożliwia skryptom analizowanie, nawigowanie i tworzenie dokumentów XML w ramach programowania. |
Attribute
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
get | String | Pobiera lokalną nazwę atrybutu. |
get | Namespace | Pobiera nazwę przestrzeni nazw atrybutu. |
get | String | Pobiera wartość atrybutu. |
set | Attribute | Ustawia lokalną nazwę atrybutu. |
set | Attribute | Ustawia przestrzeń nazw dla atrybutu. |
set | 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. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera wartość tekstową węzła Text. |
get | 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. |
set | 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. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera wartość tekstową węzła Comment. |
get | 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. |
set | Comment | Ustawia wartość tekstową węzła Comment. |
Content
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
as | Cdata | Przekształca węzeł w węzeł CDATASection na potrzeby autouzupełniania. |
as | Comment | Przekształca węzeł w węzeł Comment na potrzeby autouzupełniania. |
as | Doc | Przekształca węzeł w węzeł Document na potrzeby autouzupełniania. |
as | Element | Przekształca węzeł w węzeł Element na potrzeby autouzupełniania. |
as | Entity | Przekształca węzeł w węzeł Entity na potrzeby autouzupełniania. |
as | Processing | Przekształca węzeł w węzeł Processing na potrzeby autouzupełniania. |
as | 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. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | Content | Pobiera typ treści węzła. |
get | 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. |
Content Type
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 Document. |
ELEMENT | Enum | Węzeł XML Element. |
ENTITYREF | Enum | Węzeł XML Entity. |
PROCESSINGINSTRUCTION | Enum | Węzeł XML Processing. |
TEXT | Enum | Węzeł XML Text. |
Doc Type
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
detach() | Content | Odłącza węzeł od nadrzędnego węzła Element. |
get | String | Pobiera nazwę wierzchołka Element głównego określonego w deklaracji Doc. |
get | String | Pobiera dane wewnętrznego podzbioru węzła Document. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera publiczny identyfikator zewnętrznych danych podzbioru dla węzła Document. |
get | String | Pobiera identyfikator systemu danych zewnętrznych podzbioru dla węzła Document. |
get | 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. |
set | Doc | Ustawia nazwę węzła Element, który ma być podany w deklaracji Doc. |
set | Doc | Ustawia dane wewnętrznego podzbioru dla węzła Document. |
set | Doc | Ustawia publiczny identyfikator zewnętrznego podzbioru danych dla węzła Document. |
set | Doc | Ustawia identyfikator systemu danych zewnętrznych podzbioru dla węzła Document. |
Document
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Document | Dodaje podany węzeł na końcu dokumentu. |
add | Document | Wstawia dany węzeł pod podanym indeksem wśród wszystkich węzłów, które są bezpośrednimi podrzędnymi dokumentu. |
clone | Content[] | Tworzy kopie wszystkich nieprzypisanych węzłów, które są bezpośrednimi podrzędnymi dokumentu. |
detach | Element | Odłącza i zwraca węzeł główny Element dokumentu. |
get | Content[] | Pobiera wszystkie węzły, które są bezpośrednimi podrzędnymi dokumentu. |
get | Content | Pobiera węzeł o danym indeksie spośród wszystkich węzłów, które są bezpośrednimi podrzędnymi dokumentu. |
get | Integer | Pobiera liczbę węzłów, które są bezpośrednimi podrzędnymi dokumentu. |
get | 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. |
get | Doc | Pobiera deklarację Doc dokumentu. |
get | Element | Pobiera główny Element węzeł dokumentu. |
has | Boolean | Określa, czy dokument ma węzeł główny Element. |
remove | Content[] | Usuwa wszystkie węzły, które są bezpośrednimi podrzędnymi dokumentu. |
remove | Boolean | Usuwa podany węzeł, jeśli jest on bezpośrednio podrzędnym węzłem dokumentu. |
remove | Content | Usuwa węzeł o danym indeksie spośród wszystkich węzłów, które są bezpośrednimi podrzędnymi dokumentu. |
set | Document | Ustawia deklarację Doc dokumentu. |
set | Document | Ustawia Element, czyli wierzchołek dokumentu. |
Element
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Element | Dodaje podany węzeł jako ostatni element podrzędny węzła Element. |
add | 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. |
clone | 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. |
get | Content[] | Pobiera wszystkie węzły, które są bezpośrednimi podrzędnymi węzła {@code Element}. |
get | Attribute | Pobiera atrybut węzła Element o podanej nazwie bez podawania przestrzeni nazw. |
get | Attribute | Pobiera atrybut węzła Element o podanej nazwie i przestrzeni nazw. |
get | Attribute[] | Pobiera wszystkie atrybuty węzła Element w kolejności, w jakiej występują w dokumencie. |
get | 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. |
get | 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. |
get | 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. |
get | 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. |
get | 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. |
get | 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. |
get | 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. |
get | 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}. |
get | Integer | Pobiera liczbę węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}. |
get | 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. |
get | Document | Pobiera dokument XML zawierający węzeł {@code Element}. |
get | String | Pobiera lokalną nazwę węzła Element. |
get | Namespace | Pobiera nazwę przestrzeni nazw węzła Element. |
get | Namespace | Pobiera przestrzeń nazw z danym prefiksem dla węzła Element. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera nazwę lokalną i prefiks przestrzeni nazw węzła Element w formacie [namespacePrefix]:[localName]. |
get | String | Pobiera wartość tekstową węzła Element. |
get | 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. |
is | Boolean | Określa, czy ten węzeł Element jest węzłem nadrzędnym bezpośrednim czy pośrednim danego węzła Element. |
is | Boolean | Określa, czy węzeł Element jest węzłem głównym dokumentu. |
remove | Boolean | Usuwa dany atrybut z tego węzła Element, jeśli taki atrybut istnieje. |
remove | Boolean | Usuwa atrybut tego węzła Element o danej nazwie i bez przestrzeni nazw, jeśli taki atrybut istnieje. |
remove | Boolean | Usuwa atrybut tego węzła Element o danej nazwie i w danej przestrzeni nazw, jeśli taki atrybut istnieje. |
remove | Content[] | Usuwa wszystkie węzły, które są bezpośrednimi podrzędnymi węzła {@code Element}. |
remove | Boolean | Usuwa podany węzeł, jeśli jest on bezpośrednim podrzędnym węzła {@code Element}. |
remove | 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}. |
set | Element | Ustawia podany atrybut dla tego węzła Element. |
set | Element | Ustawia atrybut tego węzła Element z podaną nazwą, wartością i bez przestrzeni nazw. |
set | Element | Ustawia atrybut tego węzła Element z podaną nazwą, wartością i przestrzenią nazw. |
set | Element | Ustawia lokalną nazwę węzła Element. |
set | Element | Ustawia przestrzeń nazw dla węzła Element. |
set | Element | Ustawia wartość tekstową węzła Element. |
Entity Ref
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
detach() | Content | Odłącza węzeł od nadrzędnego węzła Element. |
get | String | Pobiera nazwę węzła Entity. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera publiczny identyfikator węzła Entity. |
get | String | Pobiera identyfikator systemu węzła Entity. |
get | 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. |
set | Entity | Ustawia nazwę węzła Entity. |
set | Entity | Ustawia publiczny identyfikator węzła Entity. |
set | Entity | Ustawia identyfikator systemu węzła Entity. |
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. |
set | Format | Określa kodowanie znaków, którego ma używać formatowanie. |
set | Format | Ustawia ciąg znaków używany do wcięcia węzłów podrzędnych względem ich węzłów nadrzędnych. |
set | Format | Ustawia ciąg znaków do wstawienia, gdy formatowanie normalnie wstawia podział wiersza. |
set | Format | Określa, czy formatowanie powinno pomijać deklarację XML, np. <?xml version="1.0"
encoding="UTF-8"?>. |
set | 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 |
|---|---|---|
get | String | Pobiera prefiks przestrzeni nazw. |
get | String | Pobiera identyfikator URI przestrzeni nazw. |
Processing Instruction
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
detach() | Content | Odłącza węzeł od nadrzędnego węzła Element. |
get | String | Pobiera nieprzetworzone dane dotyczące każdej instrukcji w węźle Processing. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera wartość docelową węzła Processing. |
get | 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. |
get | Element | Pobiera węzeł nadrzędny Element węzła. |
get | String | Pobiera wartość tekstową węzła Text. |
get | 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. |
set | Text | Ustawia wartość tekstową węzła Text. |
Xml Service
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
Content | Content | Wyliczenie reprezentujące typy węzłów treści XML. |
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
create | Cdata | Tworzy niepowiązany węzeł CDATASection z określoną wartością. |
create | Comment | Tworzy niepowiązany węzeł Comment z określoną wartością. |
create | Doc | Tworzy niepowiązany węzeł Document dla węzła głównego Element o podanej nazwie. |
create | Doc | Tworzy niepowiązany węzeł Document dla węzła Element z daną nazwą i danym identyfikatorem systemowym dla danych zewnętrznych podzbioru. |
create | Doc | Tworzy nieprzyłączony węzeł Document dla węzła Element z podaną nazwą oraz podanym identyfikatorem publicznym i identyfikatorem systemowym dla danych zewnętrznych podzbioru. |
create | Document | Tworzy pusty dokument XML. |
create | Document | Tworzy dokument XML z danym węzłem głównym Element. |
create | Element | Tworzy niepowiązany węzeł Element o podanej nazwie lokalnej i bez przestrzeni nazw. |
create | Element | Tworzy niepowiązany węzeł Element z daną nazwą lokalną i przestrzenią nazw. |
create | Text | Tworzy niepowiązany węzeł Text z określoną wartością. |
get | Format | Tworzy obiekt Format, aby wygenerować skompresowany dokument XML. |
get | Namespace | Tworzy obiekt Namespace z podanym identyfikatorem URI. |
get | Namespace | Tworzy Namespace z danym prefiksem i identyfikatorem URI. |
get | Namespace | Tworzy Namespace, który reprezentuje brak prawdziwej przestrzeni nazw. |
get | Format | Tworzy obiekt Format, aby wygenerować czytelny dla człowieka dokument XML. |
get | Format | Tworzy obiekt Format, aby wygenerować surowy dokument XML. |
get | Namespace | Tworzy Namespace ze standardowym prefiksem xml. |
parse(xml) | Document | Tworzy Document z podanego kodu XML bez jego weryfikacji. |