تتيح هذه الخدمة النصوص البرمجية لتحليل مستندات 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
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
CDATA | Enum | عُقدة XML CDATASection . |
COMMENT | Enum | عُقدة XML Comment . |
DOCTYPE | Enum | عُقدة XML DocumentType . |
ELEMENT | Enum | عُقدة XML Element . |
ENTITYREF | Enum | عُقدة XML EntityReference . |
PROCESSINGINSTRUCTION | Enum | عُقدة XML ProcessingInstruction . |
TEXT | Enum | عُقدة 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 لتحديدها في إعلان 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[] | ينشئ نُسخًا غير مرتبطة من جميع العُقد التي تكون عبارة عن عناصر ثانوية مباشرة للعقدة Elementcode Element}. |
detach() | Content | لفصل العقدة عن العقدة Element الرئيسية. |
getAllContent() | Content[] | يحصل على جميع العُقد التي تكون العناصر الثانوية المباشرة للعُقدة في RFCcode 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}codecode Element}. |
getContentSize() | Integer | تعرض هذه السمة عدد العُقد التي تشير إلى عُقدة عنصر DIVcode في الحال}. |
getDescendants() | Content[] | يحصل على كل العُقد التي تكون مباشرة أو غير مباشرة للعقدة Elementcode Element}، بالترتيب الذي تظهر به في المستند. |
getDocument() | Document | تحصل على مستند XML الذي يحتوي على عُقدة عنصر =\"code}. |
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[] | إزالة جميع العُقد التي تكون العناصر الثانوية المباشرة للعقدة DIVcode Element}. |
removeContent(content) | Boolean | إزالة العقدة المحددة، إذا كانت العقدة عنصرًا ثانويًا فوريًا من عقدة DIVcode Element}. |
removeContent(index) | Content | إزالة العقدة في الفهرس المحدد بين جميع العُقد التي تكون العناصر الثانوية المباشرة للعُقدة في {1}codecode Element}. |
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
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
ContentTypes | ContentType | قائمة تعداد تمثل أنواع عُقد محتوى 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. |