השירות הזה מאפשר לסקריפטים לנתח מסמכי 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); }
שיעורים
| שם | תיאור קצר |
|---|---|
Attribute | ייצוג של מאפיין XML. |
Cdata | ייצוג של צומת CDATASection XML. |
Comment | ייצוג של צומת Comment XML. |
Content | ייצוג של צומת XML כללי. |
Content | ספירה שמייצגת את הסוגים של צמתי תוכן ב-XML. |
Doc | ייצוג של צומת Document XML. |
Document | ייצוג של מסמך XML. |
Element | ייצוג של צומת Element XML. |
Entity | ייצוג של צומת Entity XML. |
Format | מעצב לפלט של מסמך XML, עם שלושה פורמטים מוגדרים מראש שאפשר להתאים אישית. |
Namespace | ייצוג של מרחב שמות XML. |
Processing | ייצוג של צומת Processing XML. |
Text | ייצוג של צומת Text XML. |
Xml | השירות הזה מאפשר לסקריפטים לנתח מסמכי XML, לנווט בהם וליצור אותם באופן פרוגרמטי. |
Attribute
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | String | מחזירה את השם המקומי של המאפיין. |
get | Namespace|null | מחזירה את מרחב השמות של המאפיין. |
get | String | קבלת הערך של המאפיין. |
set | Attribute | מגדיר את השם המקומי של המאפיין. |
set | Attribute | מגדיר את מרחב השמות של המאפיין. |
set | Attribute | הגדרת הערך של המאפיין. |
Cdata
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
append(text) | Text | הפונקציה מוסיפה את הטקסט שצוין לתוכן שכבר קיים בצומת. |
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | Element|null | מחזירה את צומת ההורה של הצומת Element. |
get | String | מקבלת את ערך הטקסט של הצומת Text. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
set | Text | מגדירה את ערך הטקסט של הצומת Text. |
Comment
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | Element|null | מקבל את צומת ההורה Element של הצומת. |
get | String | מקבלת את ערך הטקסט של הצומת Comment. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
set | Comment | מגדירה את ערך הטקסט של הצומת Comment. |
Content
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
as | Cdata|null | הפונקציה מעבירה את הצומת כצומת CDATASection לצורך השלמה אוטומטית. |
as | Comment|null | הפונקציה מעבירה את הצומת כצומת Comment לצורך השלמה אוטומטית. |
as | Doc | הפונקציה מעבירה את הצומת כצומת Document לצורך השלמה אוטומטית. |
as | Element|null | הפונקציה מעבירה את הצומת כצומת Element לצורך השלמה אוטומטית. |
as | Entity | הפונקציה מעבירה את הצומת כצומת Entity לצורך השלמה אוטומטית. |
as | Processing | הפונקציה מעבירה את הצומת כצומת Processing לצורך השלמה אוטומטית. |
as | Text|null | הפונקציה מעבירה את הצומת כצומת Text לצורך השלמה אוטומטית. |
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | Element|null | מקבל את צומת ההורה Element של הצומת. |
get | Content | מחזירה את סוג התוכן של הצומת. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
Content Type
מאפיינים
| נכס | סוג | תיאור |
|---|---|---|
CDATA | Enum | צומת CDATASection ב-XML. |
COMMENT | Enum | צומת Comment ב-XML. |
DOCTYPE | Enum | צומת Document ב-XML. |
ELEMENT | Enum | צומת Element ב-XML. |
ENTITYREF | Enum | צומת Entity ב-XML. |
PROCESSINGINSTRUCTION | Enum | צומת Processing של XML. |
TEXT | Enum | צומת Text של XML. |
Doc Type
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | String | מקבל את השם של צומת הבסיס Element שצוין בהצהרת Doc. |
get | String | קבלת נתוני קבוצת המשנה הפנימית של הצומת Document. |
get | Element|null | מקבל את צומת ההורה Element של הצומת. |
get | String | מקבל את המזהה הציבורי של נתוני קבוצת המשנה החיצונית עבור הצומת Document. |
get | String | מקבל את מזהה המערכת של נתוני קבוצת המשנה החיצונית עבור הצומת Document. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
set | Doc | הגדרה של שם צומת הבסיס Element שצריך לציין בהצהרה Doc
|
set | Doc | הגדרת נתוני קבוצת המשנה הפנימית לצומת Document. |
set | Doc | הגדרת המזהה הציבורי של נתוני קבוצת המשנה החיצונית עבור הצומת Document. |
set | Doc | מגדירה את מזהה המערכת של נתוני קבוצת המשנה החיצונית עבור הצומת Document. |
Document
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Document | מוסיף את הצומת הנתון לסוף המסמך. |
add | Document | מוסיף את הצומת הנתון באינדקס הנתון בין כל הצמתים שהם צאצאים ישירים של המסמך. |
clone | Content[] | יוצר עותקים לא מצורפים של כל הצמתים שהם צאצאים ישירים של המסמך. |
detach | Element|null | מנתק את צומת השורש Element של המסמך ומחזיר אותו. |
get | Content[] | מחזירה את כל הצמתים שהם צאצאים ישירים של המסמך. |
get | Content|null | מחזירה את הצומת באינדקס הנתון מבין כל הצמתים שהם צאצאים ישירים של המסמך. |
get | Integer | הפונקציה מחזירה את מספר הצמתים שהם צאצאים ישירים של המסמך. |
get | Content[] | מחזירה את כל הצמתים שהם צאצאים ישירים או עקיפים של המסמך, לפי הסדר שבו הם מופיעים במסמך. |
get | Doc | מחזירה את Docההצהרה של המסמך. |
get | Element|null | מחזירה את צומת השורש Element של המסמך. |
has | Boolean | הפונקציה קובעת אם במסמך יש צומת Element בסיס. |
remove | Content[] | הסרת כל הצמתים שהם צאצאים ישירים של המסמך. |
remove | Boolean | הפונקציה מסירה את הצומת שצוין, אם הצומת הוא צאצא ישיר של המסמך. |
remove | Content|null | הפונקציה מסירה את הצומת באינדקס הנתון מבין כל הצמתים שהם צאצאים ישירים של המסמך. |
set | Document | הגדרת ההצהרה Doc של המסמך. |
set | Document | הגדרת צומת השורש Element של המסמך. |
Element
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Element | מוסיף את הצומת הנתון כצאצא האחרון של הצומת Element. |
add | Element | הפונקציה מוסיפה את הצומת הנתון באינדקס הנתון בין כל הצמתים שהם צאצאים ישירים של הצומת Element. |
clone | Content[] | יוצר עותקים לא מצורפים של כל הצמתים שהם צאצאים ישירים של צומת {@code Element}. |
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | Content[] | מחזירה את כל הצמתים שהם צאצאים ישירים של צומת {@code Element}. |
get | Attribute|null | מחזירה את המאפיין של צומת Element הזה עם השם הנתון וללא מרחב שמות. |
get | Attribute|null | מחזירה את המאפיין של צומת Element הזה עם השם ומרחב השמות שצוינו. |
get | Attribute[] | מקבל את כל המאפיינים של הצומת Element הזה, לפי הסדר שבו הם מופיעים במסמך. |
get | Element|null | מחזירה את הצומת הראשון Element עם השם הנתון וללא מרחב שמות, שהוא צאצא מיידי של הצומת Element. |
get | Element|null | מחזירה את הצומת הראשון Element עם השם ומרחב השמות הנתונים, שהוא צאצא ישיר של הצומת Element הזה. |
get | String|null | הפונקציה מחזירה את ערך הטקסט של הצומת עם השם הנתון וללא מרחב שמות, אם הצומת הוא צאצא ישיר של הצומת Element. |
get | String|null | הפונקציה מחזירה את ערך הטקסט של הצומת עם השם ומרחב השמות שצוינו, אם הצומת הוא צאצא ישיר של הצומת Element. |
get | Element[] | מחזירה את כל הצמתים מסוג Element שהם צאצאים ישירים של הצומת Element הזה, בסדר שבו הם מופיעים במסמך. |
get | Element[] | מחזירה את כל הצמתים Element עם השם הנתון וללא מרחב שמות, שהם צאצאים ישירים של הצומת Element הזה, לפי הסדר שבו הם מופיעים במסמך. |
get | Element[] | מחזירה את כל הצמתים Element עם השם ומרחב השמות שצוינו, שהם צאצאים ישירים של הצומת Element, לפי הסדר שבו הם מופיעים במסמך. |
get | Content|null | מחזירה את הצומת באינדקס הנתון מבין כל הצמתים שהם צאצאים ישירים של הצומת {@code Element}. |
get | Integer | הפונקציה מחזירה את מספר הצמתים שהם צאצאים ישירים של צומת {@code Element}. |
get | Content[] | מחזירה את כל הצמתים שהם צאצאים ישירים או עקיפים של צומת {@code Element}, לפי הסדר שבו הם מופיעים במסמך. |
get | Document | מחזירה את מסמך ה-XML שמכיל את הצומת {@code Element}. |
get | String | מחזירה את השם המקומי של הצומת Element. |
get | Namespace | הפונקציה מחזירה את מרחב השמות של הצומת Element. |
get | Namespace | קבלת מרחב השמות עם הקידומת הנתונה עבור הצומת Element. |
get | Element|null | מחזירה את צומת ההורה של הצומת Element. |
get | String | מחזירה את השם המקומי ואת קידומת מרחב השמות של הצומת Element, בצורה [namespacePrefix]:[localName]. |
get | String | מקבלת את ערך הטקסט של הצומת Element. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
is | Boolean | הפונקציה קובעת אם הצומת Element הוא הורה ישיר או עקיף של הצומת Element. |
is | Boolean | קובע אם הצומת Element הוא צומת הבסיס של המסמך. |
remove | Boolean | מסיר את המאפיין שצוין מהצומת Element, אם מאפיין כזה קיים. |
remove | Boolean | מסיר את המאפיין של הצומת Element הזה עם השם הנתון וללא מרחב שמות, אם קיים מאפיין כזה. |
remove | Boolean | מסיר את המאפיין של הצומת Element עם השם ומרחב השמות שצוינו, אם קיים מאפיין כזה. |
remove | Content[] | הפונקציה מסירה את כל הצמתים שהם צאצאים ישירים של צומת {@code Element}. |
remove | Boolean | מסירה את הצומת הנתון, אם הצומת הוא צאצא ישיר של צומת {@code Element}. |
remove | Content|null | מסירה את הצומת באינדקס הנתון מבין כל הצמתים שהם צאצאים ישירים של הצומת {@code Element}. |
set | Element | הגדרת המאפיין שצוין לצומת Element. |
set | Element | מגדיר את המאפיין של צומת Element הזה עם השם, הערך ומרחב השמות שצוינו. |
set | Element | מגדיר את המאפיין של הצומת Element הזה עם השם, הערך ומרחב השמות שצוינו. |
set | Element | מגדיר את השם המקומי של צומת Element. |
set | Element | מגדיר את מרחב השמות של הצומת Element. |
set | Element | מגדירה את ערך הטקסט של הצומת Element. |
Entity Ref
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | String | הפונקציה מחזירה את השם של צומת Entity. |
get | Element|null | מחזירה את צומת ההורה של הצומת Element. |
get | String|null | מקבל את המזהה הציבורי של הצומת Entity. |
get | String|null | הפונקציה מחזירה את מזהה המערכת של הצומת Entity. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
set | Entity | מגדיר את השם של צומת Entity. |
set | Entity | מגדירה את המזהה הציבורי של הצומת Entity. |
set | Entity | מגדירה את מזהה המערכת של הצומת Entity. |
Format
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
format(document) | String | הפונקציה מחזירה את הערך Document כמחרוזת בפורמט מסוים. |
format(element) | String | מחזירה את הצומת Element שצוין כמחרוזת מעוצבת. |
set | Format | מגדיר את קידוד התווים שבו המעצב צריך להשתמש. |
set | Format | מגדירה את המחרוזת שמשמשת להזחת צמתים משניים ביחס לצמתים הראשיים שלהם. |
set | Format | מגדיר את המחרוזת להוספה בכל פעם שהמעצב אמור להוסיף מעבר שורה. |
set | Format | קובע אם מעצב הפורמט צריך להשמיט את הצהרת ה-XML, כמו <?xml version="1.0"
encoding="UTF-8"?>. |
set | Format | קובע אם מעצב הפורמט צריך להשמיט את הקידוד בהצהרת ה-XML, כמו שדה הקידוד ב-<?xml version="1.0" encoding="UTF-8"?>. |
Namespace
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | String | קבלת הקידומת של מרחב השמות. |
get | String | קבלת ה-URI של מרחב השמות. |
Processing Instruction
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | String | מקבל את הנתונים הגולמיים של כל הוראה בצומת Processing. |
get | Element|null | מקבל את צומת ההורה Element של הצומת. |
get | String | הפונקציה מחזירה את היעד של הצומת Processing. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
Text
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
append(text) | Text | הוספת הטקסט הנתון לתוכן שכבר קיים בצומת. |
detach() | Content|null | מנתק את הצומת מצומת ההורה Element. |
get | Element|null | מקבל את צומת ההורה Element של הצומת. |
get | String | מקבלת את ערך הטקסט של הצומת Text. |
get | String | מחזירה את ערך הטקסט של כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת, לפי הסדר שבו הם מופיעים במסמך. |
set | Text | מגדירה את ערך הטקסט של הצומת Text. |
Xml Service
מאפיינים
| נכס | סוג | תיאור |
|---|---|---|
Content | Content | ספירה שמייצגת את הסוגים של צמתי תוכן ב-XML. |
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
create | Cdata | יוצרת צומת CDATASection לא מצורף עם הערך הנתון. |
create | Comment | יוצרת צומת Comment לא מצורף עם הערך הנתון. |
create | Doc | יוצרת צומת Document לא מצורף לצומת Element הבסיסי עם השם שצוין. |
create | Doc | יוצר צומת Document לא מצורף לצומת הבסיס Element עם השם שצוין ומזהה המערכת שצוין לנתוני קבוצת המשנה החיצונית. |
create | Doc | יוצר צומת Document לא מצורף לצומת הבסיס Element עם השם הנתון, המזהה הציבורי הנתון ומזהה המערכת הנתון לנתוני קבוצת המשנה החיצונית. |
create | Document | יוצר מסמך XML ריק. |
create | Document | יוצרת מסמך XML עם צומת הבסיס Element שצוין. |
create | Element | הפונקציה יוצרת צומת Element לא מצורף עם השם המקומי שצוין וללא מרחב שמות. |
create | Element | הפונקציה יוצרת צומת Element לא מצורף עם השם המקומי ומרחב השמות שצוינו. |
create | Text | יוצרת צומת Text לא מצורף עם הערך הנתון. |
get | Format | יוצרת אובייקט Format לפלט של מסמך XML קומפקטי. |
get | Namespace | הפונקציה יוצרת Namespace עם ה-URI שצוין. |
get | Namespace | הפונקציה יוצרת Namespace עם הקידומת וה-URI שצוינו. |
get | Namespace | הפונקציה יוצרת Namespace שמייצג את היעדר מרחב שמות אמיתי. |
get | Format | יוצרת אובייקט Format כדי להפיק מסמך XML שקריא לאנשים. |
get | Format | יוצר אובייקט Format לפלט של מסמך XML גולמי. |
get | Namespace | יוצר Namespace עם הקידומת הרגילה xml. |
parse(xml) | Document | הפונקציה יוצרת Document מ-XML נתון, בלי לאמת את ה-XML. |