Ce service permet aux scripts d'analyser, de naviguer et de créer des documents XML par programmation.
// 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
| Nom | Brève description |
|---|---|
Attribute | Représentation d'un attribut XML. |
Cdata | Représentation d'un nœud XML CDATASection. |
Comment | Représentation d'un nœud XML Comment. |
Content | Représentation d'un nœud XML générique. |
Content | Énumération représentant les types de nœuds de contenu XML. |
Doc | Représentation d'un nœud XML Document. |
Document | Représentation d'un document XML. |
Element | Représentation d'un nœud XML Element. |
Entity | Représentation d'un nœud XML Entity. |
Format | Formateur permettant de générer un document XML, avec trois formats prédéfinis pouvant être personnalisés. |
Namespace | Représentation d'un espace de noms XML. |
Processing | Représentation d'un nœud XML Processing. |
Text | Représentation d'un nœud XML Text. |
Xml | Ce service permet aux scripts d'analyser, de naviguer et de créer des documents XML par programmation. |
Attribute
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | String | Récupère le nom local de l'attribut. |
get | Namespace | Récupère l'espace de noms de l'attribut. |
get | String | Récupère la valeur de l'attribut. |
set | Attribute | Définit le nom local de l'attribut. |
set | Attribute | Définit l'espace de noms de l'attribut. |
set | Attribute | Définit la valeur de l'attribut. |
Cdata
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
append(text) | Text | Ajoute le texte donné à tout contenu existant déjà dans le nœud. |
detach() | Content | Détache le nœud de son nœud Element parent. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère la valeur textuelle du nœud Text. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
set | Text | Définit la valeur textuelle du nœud Text. |
Comment
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
detach() | Content | Détache le nœud de son nœud Element parent. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère la valeur textuelle du nœud Comment. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
set | Comment | Définit la valeur textuelle du nœud Comment. |
Content
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
as | Cdata | Convertit le nœud en nœud CDATASection à des fins de saisie semi-automatique. |
as | Comment | Convertit le nœud en nœud Comment à des fins de saisie semi-automatique. |
as | Doc | Convertit le nœud en nœud Document à des fins de saisie semi-automatique. |
as | Element | Convertit le nœud en nœud Element à des fins de saisie semi-automatique. |
as | Entity | Convertit le nœud en nœud Entity à des fins de saisie semi-automatique. |
as | Processing | Convertit le nœud en nœud Processing à des fins de saisie semi-automatique. |
as | Text | Convertit le nœud en nœud Text à des fins de saisie semi-automatique. |
detach() | Content | Détache le nœud de son nœud Element parent. |
get | Element | Récupère le nœud Element parent du nœud. |
get | Content | Récupère le type de contenu du nœud. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
Content Type
Propriétés
| Propriété | Type | Description |
|---|---|---|
CDATA | Enum | Nœud XML CDATASection. |
COMMENT | Enum | Nœud XML Comment. |
DOCTYPE | Enum | Nœud XML Document. |
ELEMENT | Enum | Nœud XML Element. |
ENTITYREF | Enum | Nœud XML Entity. |
PROCESSINGINSTRUCTION | Enum | Nœud XML Processing. |
TEXT | Enum | Nœud XML Text. |
Doc Type
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
detach() | Content | Détache le nœud de son nœud Element parent. |
get | String | Récupère le nom du nœud racine Element spécifié dans la déclaration Doc. |
get | String | Récupère les données du sous-ensemble interne pour le nœud Document. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère l'ID public des données du sous-ensemble externe pour le nœud Document. |
get | String | Récupère l'ID système des données du sous-ensemble externe pour le nœud Document. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
set | Doc | Définit le nom du nœud Element racine à spécifier dans la déclaration Doc. |
set | Doc | Définit les données du sous-ensemble interne pour le nœud Document. |
set | Doc | Définit l'ID public des données du sous-ensemble externe pour le nœud Document. |
set | Doc | Définit l'ID système des données du sous-ensemble externe pour le nœud Document. |
Document
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
add | Document | Ajoute le nœud donné à la fin du document. |
add | Document | Insère le nœud donné à l'index donné parmi tous les nœuds qui sont des enfants immédiats du document. |
clone | Content[] | Crée des copies non associées de tous les nœuds qui sont des enfants immédiats du document. |
detach | Element | Détache et renvoie le nœud racine Element du document. |
get | Content[] | Récupère tous les nœuds qui sont des enfants immédiats du document. |
get | Content | Récupère le nœud à l'index donné parmi tous les nœuds qui sont des enfants immédiats du document. |
get | Integer | Récupère le nombre de nœuds qui sont des enfants immédiats du document. |
get | Content[] | Récupère tous les nœuds qui sont des enfants directs ou indirects du document, dans l'ordre dans lequel ils apparaissent dans le document. |
get | Doc | Récupère la déclaration Doc du document. |
get | Element | Récupère le nœud Element racine du document. |
has | Boolean | Détermine si le document comporte un nœud racine Element. |
remove | Content[] | Supprime tous les nœuds qui sont des enfants immédiats du document. |
remove | Boolean | Supprime le nœud donné s'il est un enfant immédiat du document. |
remove | Content | Supprime le nœud à l'index donné parmi tous les nœuds qui sont des enfants immédiats du document. |
set | Document | Définit la déclaration Doc du document. |
set | Document | Définit le nœud Element racine du document. |
Element
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
add | Element | Ajoute le nœud donné en tant que dernier enfant du nœud Element. |
add | Element | Insère le nœud donné à l'index donné parmi tous les nœuds qui sont des enfants immédiats du nœud Element. |
clone | Content[] | Crée des copies non associées de tous les nœuds qui sont des enfants immédiats du nœud {@code Element}. |
detach() | Content | Détache le nœud de son nœud Element parent. |
get | Content[] | Récupère tous les nœuds qui sont des enfants immédiats du nœud {@code Element}. |
get | Attribute | Récupère l'attribut de ce nœud Element avec le nom donné et sans espace de noms. |
get | Attribute | Récupère l'attribut de ce nœud Element avec le nom et l'espace de noms donnés. |
get | Attribute[] | Récupère tous les attributs de ce nœud Element, dans l'ordre dans lequel ils apparaissent dans le document. |
get | Element | Obtient le premier nœud Element avec le nom donné et sans espace de noms qui est un enfant immédiat de ce nœud Element. |
get | Element | Récupère le premier nœud Element avec le nom et l'espace de noms donnés qui est un enfant immédiat de ce nœud Element. |
get | String | Récupère la valeur textuelle du nœud avec le nom donné et sans espace de noms, si le nœud est un enfant immédiat du nœud Element. |
get | String | Récupère la valeur textuelle du nœud avec le nom et l'espace de noms donnés, si le nœud est un enfant immédiat du nœud Element. |
get | Element[] | Récupère tous les nœuds Element qui sont des enfants immédiats de ce nœud Element, dans l'ordre dans lequel ils apparaissent dans le document. |
get | Element[] | Récupère tous les nœuds Element portant le nom donné et sans espace de noms qui sont des enfants immédiats de ce nœud Element, dans l'ordre dans lequel ils apparaissent dans le document. |
get | Element[] | Récupère tous les nœuds Element avec le nom et l'espace de noms donnés qui sont des enfants immédiats de ce nœud Element, dans l'ordre dans lequel ils apparaissent dans le document. |
get | Content | Récupère le nœud à l'index donné parmi tous les nœuds qui sont des enfants immédiats du nœud {@code Element}. |
get | Integer | Récupère le nombre de nœuds qui sont des enfants immédiats du nœud {@code Element}. |
get | Content[] | Récupère tous les nœuds qui sont des enfants directs ou indirects du nœud {@code Element}, dans l'ordre dans lequel ils apparaissent dans le document. |
get | Document | Récupère le document XML contenant le nœud {@code Element}. |
get | String | Récupère le nom local du nœud Element. |
get | Namespace | Récupère l'espace de noms du nœud Element. |
get | Namespace | Récupère l'espace de noms avec le préfixe donné pour le nœud Element. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère le nom local et le préfixe d'espace de noms du nœud Element, au format [namespacePrefix]:[localName]. |
get | String | Récupère la valeur textuelle du nœud Element. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
is | Boolean | Indique si ce nœud Element est un parent direct ou indirect d'un nœud Element donné. |
is | Boolean | Détermine si le nœud Element est le nœud racine du document. |
remove | Boolean | Supprime l'attribut donné pour ce nœud Element, si un tel attribut existe. |
remove | Boolean | Supprime l'attribut de ce nœud Element avec le nom donné et sans espace de noms, s'il existe. |
remove | Boolean | Supprime l'attribut de ce nœud Element avec le nom et l'espace de noms donnés, le cas échéant. |
remove | Content[] | Supprime tous les nœuds qui sont des enfants immédiats du nœud {@code Element}. |
remove | Boolean | Supprime le nœud donné s'il est un enfant immédiat du nœud {@code Element}. |
remove | Content | Supprime le nœud à l'index donné parmi tous les nœuds qui sont des enfants immédiats du nœud {@code Element}. |
set | Element | Définit l'attribut donné pour ce nœud Element. |
set | Element | Définit l'attribut de ce nœud Element avec le nom et la valeur donnés, sans espace de noms. |
set | Element | Définit l'attribut de ce nœud Element avec le nom, la valeur et l'espace de noms donnés. |
set | Element | Définit le nom local du nœud Element. |
set | Element | Définit l'espace de noms du nœud Element. |
set | Element | Définit la valeur textuelle du nœud Element. |
Entity Ref
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
detach() | Content | Détache le nœud de son nœud Element parent. |
get | String | Récupère le nom du nœud Entity. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère l'ID public du nœud Entity. |
get | String | Récupère l'ID système du nœud Entity. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
set | Entity | Définit le nom du nœud Entity. |
set | Entity | Définit l'ID public du nœud Entity. |
set | Entity | Définit l'ID système du nœud Entity. |
Format
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
format(document) | String | Affiche l'Document donné sous forme de chaîne formatée. |
format(element) | String | Affiche le nœud Element donné sous forme de chaîne formatée. |
set | Format | Définit l'encodage de caractères que le formateur doit utiliser. |
set | Format | Définit la chaîne utilisée pour indenter les nœuds enfants par rapport à leurs parents. |
set | Format | Définit la chaîne à insérer chaque fois que le formateur insère normalement un saut de ligne. |
set | Format | Indique si le formateur doit omettre la déclaration XML, par exemple <?xml version="1.0"
encoding="UTF-8"?>. |
set | Format | Indique si le formateur doit omettre l'encodage dans la déclaration XML, comme le champ d'encodage dans <?xml version="1.0" encoding="UTF-8"?>. |
Namespace
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | String | Récupère le préfixe de l'espace de noms. |
get | String | Récupère l'URI de l'espace de noms. |
Processing Instruction
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
detach() | Content | Détache le nœud de son nœud Element parent. |
get | String | Récupère les données brutes pour chaque instruction du nœud Processing. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère la cible du nœud Processing. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
Text
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
append(text) | Text | Ajoute le texte donné à tout contenu existant déjà dans le nœud. |
detach() | Content | Détache le nœud de son nœud Element parent. |
get | Element | Récupère le nœud Element parent du nœud. |
get | String | Récupère la valeur textuelle du nœud Text. |
get | String | Récupère la valeur textuelle de tous les nœuds qui sont des enfants directs ou indirects du nœud, dans l'ordre dans lequel ils apparaissent dans le document. |
set | Text | Définit la valeur textuelle du nœud Text. |
Xml Service
Propriétés
| Propriété | Type | Description |
|---|---|---|
Content | Content | Énumération représentant les types de nœuds de contenu XML. |
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
create | Cdata | Crée un nœud CDATASection non associé avec la valeur donnée. |
create | Comment | Crée un nœud Comment non associé avec la valeur donnée. |
create | Doc | Crée un nœud Document non associé au nœud Element racine avec le nom donné. |
create | Doc | Crée un nœud Document non associé au nœud racine Element avec le nom donné et l'ID système donné pour les données du sous-ensemble externe. |
create | Doc | Crée un nœud Document non associé au nœud Element racine avec le nom donné, ainsi que l'ID public et l'ID système donnés pour les données du sous-ensemble externe. |
create | Document | Crée un document XML vide. |
create | Document | Crée un document XML avec le nœud racine Element donné. |
create | Element | Crée un nœud Element non associé avec le nom local donné et sans espace de noms. |
create | Element | Crée un nœud Element non associé avec le nom local et l'espace de noms donnés. |
create | Text | Crée un nœud Text non associé avec la valeur donnée. |
get | Format | Crée un objet Format pour générer un document XML compact. |
get | Namespace | Crée un Namespace avec l'URI donné. |
get | Namespace | Crée un Namespace avec le préfixe et l'URI donnés. |
get | Namespace | Crée un Namespace qui représente l'absence d'un espace de noms réel. |
get | Format | Crée un objet Format pour générer un document XML lisible par l'humain. |
get | Format | Crée un objet Format pour générer un document XML brut. |
get | Namespace | Crée un Namespace avec le préfixe xml standard. |
parse(xml) | Document | Crée une Document à partir du fichier XML donné, sans le valider. |