Ta usługa umożliwia skryptom analizowanie dokumentów XML, poruszanie się po nich i tworzenie ich w sposób programowy.
// 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 | Reprezentacja węzła XMLCDATASection. |
Comment | Reprezentacja węzła XMLComment. |
Content | Reprezentacja ogólnego węzła XML. |
Content | Wyliczenie reprezentujące typy węzłów treści XML. |
Doc | Reprezentacja węzła XMLDocument. |
Document | Reprezentacja dokumentu XML. |
Element | Reprezentacja węzła XMLElement. |
Entity | Reprezentacja węzła XMLEntity. |
Format | Formatowanie do generowania dokumentu XML z 3 wstępnie zdefiniowanymi formatami, które można dodatkowo dostosować. |
Namespace | Reprezentacja przestrzeni nazw XML. |
Processing | Reprezentacja węzła XMLProcessing. |
Text | Reprezentacja węzła XMLText. |
Xml | Ta usługa umożliwia skryptom analizowanie dokumentów XML, poruszanie się po nich i tworzenie ich w sposób programowy. |
Attribute
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
get | String | Pobiera lokalną nazwę atrybutu. |
get | Namespace|null | Pobiera przestrzeń nazw atrybutu. |
get | String | Pobiera wartość atrybutu. |
set | Attribute | Ustawia lokalną nazwę atrybutu. |
set | Attribute | Ustawia przestrzeń nazw atrybutu. |
set | Attribute | Ustawia wartość atrybutu. |
Cdata
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
append(text) | Text | Dołącza podany tekst do treści, która już znajduje się w węźle. |
detach() | Content|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
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 elementami 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|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
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 elementami 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|null | Rzutuje węzeł jako węzeł CDATASection na potrzeby autouzupełniania. |
as | Comment|null | Rzutuje węzeł jako węzeł Comment na potrzeby autouzupełniania. |
as | Doc | Rzutuje węzeł jako węzeł Document na potrzeby autouzupełniania. |
as | Element|null | Rzutuje węzeł jako węzeł Element na potrzeby autouzupełniania. |
as | Entity | Rzutuje węzeł jako węzeł Entity na potrzeby autouzupełniania. |
as | Processing | Rzutuje węzeł jako węzeł Processing na potrzeby autouzupełniania. |
as | Text|null | Rzutuje węzeł jako węzeł Text na potrzeby autouzupełniania. |
detach() | Content|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
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 elementami 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|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | String | Pobiera nazwę węzła głównego Element określonego w deklaracji Doc. |
get | String | Pobiera wewnętrzne dane podzbioru dla węzła Document. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
get | String | Pobiera publiczny identyfikator zewnętrznych danych podzbioru dla węzła Document. |
get | String | Pobiera identyfikator systemowy zewnętrznych danych podzbioru dla węzła Document. |
get | String | Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi elementami podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie. |
set | Doc | Ustawia nazwę węzła głównego Element, która ma być określona w deklaracji Doc. |
set | Doc | Ustawia wewnętrzny podzbiór danych dla węzła Document. |
set | Doc | Ustawia publiczny identyfikator zewnętrznych danych podzbioru dla węzła Document. |
set | Doc | Ustawia identyfikator systemu zewnętrznego podzbioru danych dla węzła Document. |
Document
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Document | Dołącza podany węzeł na końcu dokumentu. |
add | Document | Wstawia podany węzeł pod podanym indeksem wśród wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi dokumentu. |
clone | Content[] | Tworzy niepowiązane kopie wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi dokumentu. |
detach | Element|null | Odłącza i zwraca węzeł główny Element dokumentu. |
get | Content[] | Pobiera wszystkie węzły, które są bezpośrednimi elementami podrzędnymi dokumentu. |
get | Content|null | Zwraca węzeł o podanym indeksie spośród wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi dokumentu. |
get | Integer | Zwraca liczbę węzłów, które są bezpośrednimi elementami 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 DocdeklaracjęDoc dokumentu. |
get | Element|null | Pobiera węzeł główny Element 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 elementami podrzędnymi dokumentu. |
remove | Boolean | Usuwa podany węzeł, jeśli jest on bezpośrednim elementem podrzędnym dokumentu. |
remove | Content|null | Usuwa węzeł o podanym indeksie spośród wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi dokumentu. |
set | Document | Ustawia deklarację Doc dokumentu. |
set | Document | Ustawia węzeł główny Element dokumentu. |
Element
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Element | Dołącza podany węzeł jako ostatni element podrzędny węzła Element. |
add | Element | Wstawia podany węzeł pod podanym indeksem wśród wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła Element. |
clone | Content[] | Tworzy nieprzyłączone kopie wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}. |
detach() | Content|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | Content[] | Pobiera wszystkie węzły, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}. |
get | Attribute|null | Pobiera atrybut tego węzła Element o podanej nazwie i bez przestrzeni nazw. |
get | Attribute|null | Pobiera atrybut tego węzła Element o podanej nazwie i przestrzeni nazw. |
get | Attribute[] | Pobiera wszystkie atrybuty tego węzła Element w kolejności, w jakiej występują w dokumencie. |
get | Element|null | Pobiera pierwszy węzeł Element o podanej nazwie i bez przestrzeni nazw, który jest bezpośrednim węzłem podrzędnym węzła Element. |
get | Element|null | Pobiera pierwszy węzeł Element o podanej nazwie i przestrzeni nazw, który jest bezpośrednim elementem podrzędnym węzła Element. |
get | String|null | Pobiera wartość tekstową węzła o podanej nazwie i bez przestrzeni nazw, jeśli węzeł jest bezpośrednim elementem podrzędnym węzła Element. |
get | String|null | Pobiera wartość tekstową węzła o podanej nazwie i przestrzeni nazw, jeśli węzeł jest bezpośrednim elementem podrzędnym węzła Element. |
get | Element[] | Pobiera wszystkie węzły Element, które są bezpośrednimi elementami podrzędnymi tego 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 elementami 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 przestrzeni nazw, które są bezpośrednimi elementami podrzędnymi tego węzła Element, w kolejności, w jakiej występują w dokumencie. |
get | Content|null | Zwraca węzeł o podanym indeksie spośród wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}. |
get | Integer | Zwraca 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 węzłami podrzędnymi węzła {@code Element}, w kolejności, w jakiej występują w dokumencie. |
get | Document | Zwraca dokument XML zawierający węzeł {@code Element}. |
get | String | Pobiera lokalną nazwę węzła Element. |
get | Namespace | Pobiera przestrzeń nazw węzła Element. |
get | Namespace | Pobiera przestrzeń nazw z podanym prefiksem dla węzła Element. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
get | String | Pobiera lokalną nazwę 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 elementami podrzędnymi węzła, w kolejności, w jakiej występują w dokumencie. |
is | Boolean | Określa, czy węzeł Element jest bezpośrednim czy pośrednim elementem nadrzędnym danego węzła Element. |
is | Boolean | Określa, czy węzeł Element jest węzłem głównym dokumentu. |
remove | Boolean | Usuwa podany atrybut z tego węzła Element, jeśli taki atrybut istnieje. |
remove | Boolean | Usuwa atrybut tego węzła Element o podanej nazwie i bez przestrzeni nazw, jeśli taki atrybut istnieje. |
remove | Boolean | Usuwa atrybut tego węzła Element o podanej nazwie i przestrzeni nazw, jeśli taki atrybut istnieje. |
remove | Content[] | Usuwa wszystkie węzły, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}. |
remove | Boolean | Usuwa podany węzeł, jeśli jest on bezpośrednim elementem podrzędnym węzła {@code Element}. |
remove | Content|null | Usuwa węzeł o podanym indeksie spośród wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}. |
set | Element | Ustawia podany atrybut dla tego węzła Element. |
set | Element | Ustawia atrybut dla tego węzła Element o podanej nazwie i wartości bez przestrzeni nazw. |
set | Element | Ustawia atrybut tego węzła Element o podanej nazwie, 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|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | String | Pobiera nazwę węzła Entity. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
get | String|null | Pobiera publiczny identyfikator węzła Entity. |
get | String|null | Pobiera identyfikator systemu węzła Entity. |
get | String | Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi elementami 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 | Zwraca podany argument Document jako sformatowany ciąg tekstowy. |
format(element) | String | Zwraca podany węzeł Element jako sformatowany ciąg znaków. |
set | Format | Określa kodowanie znaków, którego ma używać moduł formatujący. |
set | Format | Ustawia ciąg znaków używany do wcięcia węzłów podrzędnych względem węzłów nadrzędnych. |
set | Format | Ustawia ciąg znaków, który ma być wstawiany, gdy formatujący zwykle wstawia podział wiersza. |
set | Format | Określa, czy formatujący ma pomijać deklarację XML, np. <?xml version="1.0"
encoding="UTF-8"?>. |
set | Format | Określa, czy formatujący ma pomijać 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|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | String | Pobiera surowe dane dla każdej instrukcji w Processing węźle. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
get | String | Pobiera element docelowy węzła Processing. |
get | String | Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi elementami 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 | Dołącza podany tekst do treści, która już znajduje się w węźle. |
detach() | Content|null | Odłącza węzeł od węzła nadrzędnego Element. |
get | Element|null | Zwraca węzeł nadrzędny węzła Element. |
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 elementami 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 nieprzyłączony węzeł CDATASection o podanej wartości. |
create | Comment | Tworzy nieprzyłączony węzeł Comment o podanej wartości. |
create | Doc | Tworzy nieprzyłączony węzeł Document dla węzła głównego Element o podanej nazwie. |
create | Doc | Tworzy nieprzyłączony węzeł Document dla węzła głównego Element o podanej nazwie i podanym identyfikatorze systemowym dla zewnętrznych danych podzbioru. |
create | Doc | Tworzy nieprzyłączony węzeł Document dla węzła głównego Element o podanej nazwie oraz podany identyfikator publiczny i identyfikator systemowy dla zewnętrznego podzbioru danych. |
create | Document | Tworzy pusty dokument XML. |
create | Document | Tworzy dokument XML z podanym węzłem głównym Element. |
create | Element | Tworzy nieprzyłączony węzeł Element o podanej nazwie lokalnej i bez przestrzeni nazw. |
create | Element | Tworzy nieprzyłączony węzeł Element o podanej nazwie lokalnej i przestrzeni nazw. |
create | Text | Tworzy nieprzyłączony węzeł Text o podanej wartości. |
get | Format | Tworzy obiekt Format do generowania kompaktowego dokumentu XML. |
get | Namespace | Tworzy obiekt Namespace z podanym identyfikatorem URI. |
get | Namespace | Tworzy Namespace z podanym prefiksem i identyfikatorem URI. |
get | Namespace | Tworzy Namespace, który reprezentuje brak rzeczywistej przestrzeni nazw. |
get | Format | Tworzy obiekt Format do generowania czytelnego dokumentu XML. |
get | Format | Tworzy obiekt Format do wyświetlania nieprzetworzonego dokumentu XML. |
get | Namespace | Tworzy Namespace ze standardowym prefiksem xml. |
parse(xml) | Document | Tworzy obiekt Document z podanego kodu XML bez weryfikowania go. |