XML Service

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
שירות XML

השירות הזה מאפשר לסקריפטים לנתח, לנווט וליצור באופן פרוגרמטי מסמכי 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ייצוג של צומת XML CDATASection.
Commentייצוג של צומת XML Comment.
Contentייצוג של צומת XML גנרי.
ContentTypeמספור שמייצג את סוגי צומתי התוכן של XML.
DocTypeייצוג של צומת XML DocumentType.
Documentייצוג של מסמך XML.
Elementייצוג של צומת XML Element.
EntityRefייצוג של צומת XML EntityReference.
Formatפורמט לפלט של מסמך XML, עם שלושה פורמטים מוגדרים מראש שניתן להתאים אישית עוד יותר.
Namespaceייצוג של מרחב שמות בפורמט XML.
ProcessingInstructionייצוג של צומת XML ProcessingInstruction.
Textייצוג של צומת XML Text.
XmlServiceשירות זה מאפשר לסקריפטים לנתח, לנווט וליצור מסמכי XML באופן פרוגרמטי.

Attribute

שיטות

שיטהסוג הערך המוחזרתיאור קצר
getName()Stringקבלת השם המקומי של המאפיין.
getNamespace()Namespaceקבלת מרחב השמות של המאפיין.
getValue()Stringמקבל את הערך של המאפיין.
setName(name)Attributeמגדיר את השם המקומי של המאפיין.
setNamespace(namespace)Attributeמגדיר את מרחב השמות של המאפיין.
setValue(value)Attributeמגדיר את הערך של המאפיין.

Cdata

שיטות

שיטהסוג הערך המוחזרתיאור קצר
append(text)Textמצרפת את הטקסט הנתון לתוכן שכבר קיים בצומת.
detach()Contentניתוק של הצומת מצומת Element שלו.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getText()Stringמקבלת את ערך הטקסט של הצומת Text.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.
setText(text)Textהגדרת ערך הטקסט של הצומת Text.

Comment

שיטות

שיטהסוג הערך המוחזרתיאור קצר
detach()Contentניתוק של הצומת מצומת Element שלו.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getText()Stringמקבלת את ערך הטקסט של הצומת Comment.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.
setText(text)Commentהגדרת ערך הטקסט של הצומת Comment.

Content

שיטות

שיטהסוג הערך המוחזרתיאור קצר
asCdata()Cdataמעביר את הצומת כצומת CDATASection למטרות השלמה אוטומטית.
asComment()Commentמעביר את הצומת כצומת Comment למטרות השלמה אוטומטית.
asDocType()DocTypeמעביר את הצומת כצומת DocumentType למטרות השלמה אוטומטית.
asElement()Elementמעביר את הצומת כצומת Element למטרות השלמה אוטומטית.
asEntityRef()EntityRefמעביר את הצומת כצומת EntityReference למטרות השלמה אוטומטית.
asProcessingInstruction()ProcessingInstructionמעביר את הצומת כצומת ProcessingInstruction למטרות השלמה אוטומטית.
asText()Textמעביר את הצומת כצומת Text למטרות השלמה אוטומטית.
detach()Contentניתוק של הצומת מצומת Element שלו.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getType()ContentTypeמקבל את סוג התוכן של הצומת.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.

ContentType

נכסים

מאפיין (property)סוגתיאור
CDATAEnumצומת XML CDATASection.
COMMENTEnumצומת XML Comment.
DOCTYPEEnumצומת XML DocumentType.
ELEMENTEnumצומת XML Element.
ENTITYREFEnumצומת XML EntityReference.
PROCESSINGINSTRUCTIONEnumצומת XML ProcessingInstruction.
TEXTEnumצומת XML Text.

DocType

שיטות

שיטהסוג הערך המוחזרתיאור קצר
detach()Contentניתוק של הצומת מצומת Element שלו.
getElementName()Stringקבלת השם של הצומת Element שצוין בהצהרה DocType.
getInternalSubset()Stringמקבל את נתוני קבוצת המשנה הפנימית של הצומת DocumentType.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getPublicId()Stringמקבלת את המזהה הציבורי של נתוני קבוצת המשנה החיצונית של הצומת DocumentType.
getSystemId()Stringמקבלת את מזהה המערכת של נתוני קבוצת המשנה החיצונית של הצומת DocumentType.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.
setElementName(name)DocTypeמגדיר את שם הצומת Element הבסיסי (root) שיש לציין בDocType הצהרה.
setInternalSubset(data)DocTypeהגדרת הנתונים הפנימיים של קבוצת המשנה עבור הצומת DocumentType.
setPublicId(id)DocTypeמגדירה את המזהה הציבורי של נתוני קבוצת המשנה החיצונית של הצומת DocumentType.
setSystemId(id)DocTypeמגדיר את מזהה המערכת של נתוני קבוצת המשנה החיצונית עבור הצומת DocumentType.

Document

שיטות

שיטהסוג הערך המוחזרתיאור קצר
addContent(content)Documentמצרף את הצומת הנתון לסוף המסמך.
addContent(index, content)Documentהוספת הצומת הנתון באינדקס הנתון בין כל הצמתים שהם צאצאים מיידיים של המסמך.
cloneContent()Content[]יצירת עותקים לא מצורפים של כל הצמתים שהם צאצאים מיידיים של המסמך.
detachRootElement()Elementניתוק וחזרה של צומת הבסיס של המסמך Element.
getAllContent()Content[]מקבל את כל הצמתים שהם צאצאים מיידיים של המסמך.
getContent(index)Contentקבלת הצומת באינדקס הנתון בין כל הצמתים שהם צאצאים מיידיים של המסמך.
getContentSize()Integerקבלת מספר הצמתים שהם צאצאים מיידיים של המסמך.
getDescendants()Content[]מקבל את כל הצמתים שהם ילדים ישירים או עקיפים של המסמך, בסדר שבו הם מופיעים במסמך.
getDocType()DocTypeמקבלת את הצהרת DocType של המסמך.
getRootElement()Elementמתקבל צומת Element בסיסי של המסמך.
hasRootElement()Booleanהגדרה זו קובעת אם המסמך כולל צומת Element בסיס.
removeContent()Content[]הסרת כל הצמתים שהם צאצאים מיידיים של המסמך.
removeContent(content)Booleanהסרת הצומת הנתון, אם הצומת הוא צאצא מיידי של המסמך.
removeContent(index)Contentהסרת הצומת באינדקס הנתון בין כל הצמתים שהם צאצאים מיידיים של המסמך.
setDocType(docType)Documentמגדיר את ההצהרה DocType של המסמך.
setRootElement(element)Documentהגדרת צומת Element ברמה הבסיסית של המסמך.

Element

שיטות

שיטהסוג הערך המוחזרתיאור קצר
addContent(content)Elementמצרפת את הצומת הנתון כצאצא האחרון של הצומת Element.
addContent(index, content)Elementהוספת הצומת הנתון באינדקס הנתון בין כל הצמתים שהם צאצאים מיידיים של הצומת Element.
cloneContent()Content[]יוצר עותקים לא מצורפים של כל הצמתים שהם צאצאים מיידיים של הצומת COUNTcode}.
detach()Contentניתוק של הצומת מצומת Element שלו.
getAllContent()Content[]מקבל את כל הצמתים שהם צאצאים מיידיים של הצומת }{code Element}.
getAttribute(name)Attributeמקבל את המאפיין של הצומת הזה Element עם השם הנתון ובלי מרחב שמות.
getAttribute(name, namespace)Attributeקבלת המאפיין של הצומת הזה של Element עם השם ומרחב השמות הנתונים.
getAttributes()Attribute[]מקבל את כל המאפיינים עבור צומת Element זה, בסדר שבו הם מופיעים במסמך.
getChild(name)Elementמקבל את הצומת Element הראשון עם השם הנתון וללא מרחב שמות שהוא צאצא מיידי של הצומת הזה Element.
getChild(name, namespace)Elementקבלת הצומת הראשון של Element עם השם ומרחב השמות הנתונים, שהם צאצא מיידי של הצומת הזה ב-Element.
getChildText(name)Stringמקבל את ערך הטקסט של הצומת עם השם הנתון ללא מרחב שמות, אם הצומת הוא צאצא מיידי של הצומת Element.
getChildText(name, namespace)Stringמקבל את ערך הטקסט של הצומת עם השם ומרחב השמות הנתונים, אם הצומת הוא צאצא מיידי של הצומת Element.
getChildren()Element[]מקבל את כל Element הצמתים שהם צאצאים מיידיים של הצומת Element הזה, בסדר שבו הם מופיעים במסמך.
getChildren(name)Element[]מקבל את כל Element הצמתים עם השם שניתן ללא מרחב שמות שהם צאצאים מיידיים של צומת Element זה, בסדר שבו הם מופיעים במסמך.
getChildren(name, namespace)Element[]מקבל את כל Element הצמתים עם השם ומרחב השמות הנתונים, שהם צאצאים מיידיים של הצומת Element הזה, בסדר שבו הם מופיעים במסמך.
getContent(index)Contentמקבל את הצומת באינדקס הנתון בין כל הצמתים שהם צאצאים מיידיים של הצומת {1}{7/}code}.
getContentSize()Integerמקבל את מספר הצמתים שהם צאצאים מיידיים של הצומת \"code Element}.
getDescendants()Content[]מקבל את כל הצמתים שהם צאצאים ישירים או עקיפים של הצומת {code Element}, בסדר שבו הם מופיעים במסמך.
getDocument()Documentמקבל את מסמך ה-XML שמכיל את הצומת COUNTcode Element}.
getName()Stringקבלת השם המקומי של הצומת Element.
getNamespace()Namespaceקבלת מרחב השמות של הצומת Element.
getNamespace(prefix)Namespaceקבלת מרחב השמות עם הקידומת הנתונה של צומת Element.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getQualifiedName()Stringקבלת השם המקומי והקידומת של מרחב השמות של הצומת Element, בפורמט [namespacePrefix]:[localName].
getText()Stringמקבלת את ערך הטקסט של הצומת Element.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.
isAncestorOf(other)Booleanהגדרה זו קובעת אם הצומת Element הוא הורה ישיר או עקיף של צומת Element נתון.
isRootElement()Booleanקביעת אם הצומת Element הוא צומת הבסיס של המסמך.
removeAttribute(attribute)Booleanהסרת המאפיין הנתון בצומת הזה של Element, אם קיים מאפיין כזה.
removeAttribute(attributeName)Booleanהסרת המאפיין בצומת הזה Element עם השם הנתון וללא מרחב שמות, אם קיים מאפיין כזה.
removeAttribute(attributeName, namespace)Booleanהסרת המאפיין בצומת הזה של Element עם השם ומרחב השמות הנתונים, אם יש כזה.
removeContent()Content[]מסיר את כל הצמתים שהם צאצאים מיידיים של הצומת \"code Element}.
removeContent(content)Booleanמסיר את הצומת הנתון, אם הצומת הוא צאצא מיידי של הצומת {7/}code Element}.
removeContent(index)Contentמסירה את הצומת באינדקס הנתון בין כל הצמתים שהם צאצאים מיידיים של הצומת {1}{7/}code}.
setAttribute(attribute)Elementמגדיר את המאפיין הנתון לצומת Element הזה.
setAttribute(name, value)Elementמגדיר את המאפיין של הצומת הזה של Element עם השם, הערך וללא מרחב השמות הנתון.
setAttribute(name, value, namespace)Elementמגדיר את המאפיין של הצומת הזה של Element באמצעות השם, הערך ומרחב השמות הנתונים.
setName(name)Elementמגדיר את השם המקומי של הצומת Element.
setNamespace(namespace)Elementמגדיר את מרחב השמות עבור הצומת Element.
setText(text)Elementהגדרת ערך הטקסט של הצומת Element.

EntityRef

שיטות

שיטהסוג הערך המוחזרתיאור קצר
detach()Contentניתוק של הצומת מצומת Element שלו.
getName()Stringקבלת השם של הצומת EntityReference.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getPublicId()Stringקבלת המזהה הציבורי של הצומת EntityReference.
getSystemId()Stringקבלת מזהה המערכת של הצומת EntityReference.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.
setName(name)EntityRefמגדיר את השם של הצומת EntityReference.
setPublicId(id)EntityRefמגדיר את המזהה הציבורי של הצומת EntityReference.
setSystemId(id)EntityRefמגדיר את מזהה המערכת של הצומת EntityReference.

Format

שיטות

שיטהסוג הערך המוחזרתיאור קצר
format(document)Stringיוצרת פלט של Document הנתון כמחרוזת בפורמט.
format(element)Stringפלט של צומת Element הנתון כמחרוזת בפורמט.
setEncoding(encoding)Formatמגדיר את קידוד התווים שהפורמט צריך להשתמש בו.
setIndent(indent)Formatמגדירה את המחרוזת המשמשת להכשרת צמתים של ילדים ביחס להורים שלהם.
setLineSeparator(separator)Formatמגדירה את המחרוזת שיש להוסיף בכל פעם שהעיצוב אמור להוסיף מעבר שורה.
setOmitDeclaration(omitDeclaration)Formatקובעת אם הפורמט צריך להשמיט את הצהרת ה-XML, למשל <?xml version="1.0" encoding="UTF-8"?>.
setOmitEncoding(omitEncoding)Formatמגדירה אם הפורמט צריך להשמיט את הקידוד בהצהרת ה-XML, כמו שדה הקידוד ב-<?xml version="1.0" encoding="UTF-8"?>.

Namespace

שיטות

שיטהסוג הערך המוחזרתיאור קצר
getPrefix()Stringקבלת הקידומת של מרחב השמות.
getURI()Stringמקבלת את ה-URI של מרחב השמות.

ProcessingInstruction

שיטות

שיטהסוג הערך המוחזרתיאור קצר
detach()Contentניתוק של הצומת מצומת Element שלו.
getData()Stringמקבל את הנתונים הגולמיים עבור כל הוראה בצומת ProcessingInstruction.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getTarget()Stringקבלת היעד של הצומת ProcessingInstruction.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.

Text

שיטות

שיטהסוג הערך המוחזרתיאור קצר
append(text)Textמצרפת את הטקסט הנתון לתוכן שכבר קיים בצומת.
detach()Contentניתוק של הצומת מצומת Element שלו.
getParentElement()Elementקבלת צומת הורה של הצומת Element.
getText()Stringמקבלת את ערך הטקסט של הצומת Text.
getValue()Stringמקבל את ערך הטקסט של כל הצמתים שהם ילדים ישירים או עקיפים של הצומת, בסדר שבו הם מופיעים במסמך.
setText(text)Textהגדרת ערך הטקסט של הצומת Text.

XmlService

נכסים

מאפיין (property)סוגתיאור
ContentTypesContentTypeמספור שמייצג את סוגי צומתי התוכן של XML.

שיטות

שיטהסוג הערך המוחזרתיאור קצר
createCdata(text)Cdataיצירת צומת CDATASection לא מצורף עם הערך הנתון.
createComment(text)Commentיצירת צומת Comment לא מצורף עם הערך הנתון.
createDocType(elementName)DocTypeיצירת צומת DocumentType לא מצורף לצומת Element הבסיסי עם השם הנתון.
createDocType(elementName, systemId)DocTypeיצירת צומת DocumentType לא מצורף לצומת Element הבסיסי עם השם הנתון, ומזהה המערכת הנתון עבור נתוני קבוצת המשנה החיצונית.
createDocType(elementName, publicId, systemId)DocTypeיצירה של צומת DocumentType לא מצורף לצומת Element הראשי עם השם הנתון, ומזהה ציבורי ומזהה מערכת נתונים של קבוצת משנה חיצונית.
createDocument()Documentיצירת מסמך XML ריק.
createDocument(rootElement)Documentיצירת מסמך XML עם צומת הבסיס Element.
createElement(name)Elementיוצרת צומת Element לא מצורף עם השם המקומי הנתון וללא מרחב שמות.
createElement(name, namespace)Elementפעולה זו יוצרת צומת Element לא מצורף עם השם המקומי ומרחב השמות הנתונים.
createText(text)Textיצירת צומת Text לא מצורף עם הערך הנתון.
getCompactFormat()Formatיצירת אובייקט Format לפלט של מסמך XML קומפקטי.
getNamespace(uri)Namespaceיצירת Namespace עם ה-URI הנתון.
getNamespace(prefix, uri)Namespaceיצירת Namespace עם הקידומת הנתונה וה-URI.
getNoNamespace()Namespaceפונקציה זו יוצרת Namespace שמייצגת את ההיעדר של מרחב שמות אמיתי.
getPrettyFormat()Formatיצירת אובייקט Format לפלט מסמך XML שקריא למשתמשים.
getRawFormat()Formatיצירת אובייקט Format לפלט של מסמך XML גולמי.
getXmlNamespace()Namespaceהפונקציה יוצרת Namespace עם קידומת xml רגילה.
parse(xml)Documentיוצרת Document מה-XML הנתון, בלי לאמת את ה-XML.