تتيح هذه الخدمة للبرامج النصية تحليل مستندات 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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
get | String | تعرض هذه الطريقة الاسم المحلي للسمة. |
get | Namespace|null | تعرض هذه الطريقة مساحة الاسم الخاصة بالسمة. |
get | String | تعرض هذه الدالة قيمة السمة. |
set | Attribute | تضبط هذه السمة الاسم المحلي للسمة. |
set | Attribute | تضبط هذه السمة مساحة الاسم الخاصة بالسمة. |
set | Attribute | تضبط قيمة السمة. |
Cdata
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
append(text) | Text | تضيف هذه السمة النص المحدّد إلى أي محتوى متوفّر في العقدة. |
detach() | Content|null | يفصل العقدة عن عقدتها الرئيسية Element. |
get | Element|null | تعرض هذه السمة العقدة الرئيسية Element للعقدة. |
get | String | تعرض هذه السمة القيمة النصية لعقدة Text. |
get | String | تعرض هذه السمة قيمة النص لجميع العُقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، وذلك بالترتيب الذي تظهر به في المستند. |
set | Text | تضبط هذه السمة قيمة النص لعقدة Text. |
Comment
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
detach() | Content|null | يفصل العقدة عن عقدتها الرئيسية Element. |
get | Element|null | تعرض هذه السمة العقدة الرئيسية Element للعقدة. |
get | String | تعرض هذه السمة القيمة النصية لعقدة Comment. |
get | String | تعرض هذه السمة قيمة النص لجميع العُقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، وذلك بالترتيب الذي تظهر به في المستند. |
set | Comment | تضبط هذه السمة قيمة النص لعقدة Comment. |
Content
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
get | String | تعرض هذه السمة البادئة لمساحة الاسم. |
get | String | تعرض هذه السمة معرّف الموارد المنتظم (URI) لمساحة الاسم. |
Processing Instruction
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
detach() | Content|null | يفصل العقدة عن عقدتها الرئيسية Element. |
get | String | تعرض هذه السمة البيانات الأولية لكل تعليمات في العقدة Processing. |
get | Element|null | تعرض هذه السمة العقدة الرئيسية Element للعقدة. |
get | String | تعرض هذه السمة الهدف لعقدة Processing. |
get | String | تعرض هذه السمة قيمة النص لجميع العُقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، وذلك بالترتيب الذي تظهر به في المستند. |
Text
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
append(text) | Text | تضيف هذه السمة النص المحدّد إلى أي محتوى متوفّر في العقدة. |
detach() | Content|null | يفصل العقدة عن عقدتها الرئيسية Element. |
get | Element|null | تعرض هذه السمة العقدة الرئيسية Element للعقدة. |
get | String | تعرض هذه السمة القيمة النصية لعقدة Text. |
get | String | تعرض هذه السمة قيمة النص لجميع العُقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، وذلك بالترتيب الذي تظهر به في المستند. |
set | Text | تضبط هذه السمة قيمة النص لعقدة Text. |
Xml Service
الخصائص
| الموقع | النوع | الوصف |
|---|---|---|
Content | Content | تعداد يمثّل أنواع عقد محتوى XML. |
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
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. |