تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

XML Service

تسمح هذه الخدمة للنصوص البرمجية بتحليل مستندات 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 عامة
`ContentType`	قائمة تمثل أنواع عقد محتوى XML
`DocType`	تمثيل لعقدة `DocumentType` في XML
`Document`	تمثيل لمستند XML
`Element`	تمثيل لعقدة `Element` في XML
`EntityRef`	تمثيل لعقدة `EntityReference` في XML
`Format`	أداة تنسيق لإخراج مستند XML، مع ثلاثة تنسيقات محدّدة مسبقًا يمكن تخصيصها بشكلٍ أكبر
`Namespace`	تمثيل لمساحة اسم XML
`ProcessingInstruction`	تمثيل لعقدة `ProcessingInstruction` في XML
`Text`	تمثيل لعقدة `Text` في XML
`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`	عقدة `CDATASection` في XML
`COMMENT`	`Enum`	عقدة `Comment` في XML
`DOCTYPE`	`Enum`	عقدة `DocumentType` في XML
`ELEMENT`	`Enum`	عقدة `Element` في XML
`ENTITYREF`	`Enum`	عقدة `EntityReference` في XML
`PROCESSINGINSTRUCTION`	`Enum`	عقدة `ProcessingInstruction` في XML
`TEXT`	`Enum`	عقدة `Text` في XML

`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[]`	تُنشئ نُسخًا غير مرتبطة من جميع العقد التي تكون عناصر ثانوية مباشرةً لعقدة {@code Element}.
`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` التي تحمل الاسم ومساحة الاسم المحدّدة وتكون فرعية مباشرةً لnode `Element` هذه، وذلك بالترتيب الذي تظهر به في المستند.
`getContent(index)`	`Content`	تحصل على العقدة في الفهرس المحدّد من بين جميع العقد التي هي عناصر ثانوية مباشرة لعقدة {@code Element}.
`getContentSize()`	`Integer`	تحصل على عدد العقد التي هي عناصر ثانوية مباشرة لعقدة {@code Element}.
`getDescendants()`	`Content[]`	تحصل على جميع العقد التي هي عناصر ثانوية مباشرة أو غير مباشرة لعقدة {@code Element}، وذلك بالترتيب الذي تظهر به في المستند.
`getDocument()`	`Document`	تحصل على مستند XML الذي يحتوي على عقدة {@code 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`	تزيل هذه الوظيفة العقدة المحدّدة، إذا كانت العقدة هي عقدة فرعية مباشرة لعقدة {@code Element}.
`removeContent(index)`	`Content`	تزيل هذه الوظيفة العقدة في الفهرس المحدّد من بين جميع العقد التي هي عناصر ثانوية مباشرة لعقدة {@code 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`	تحصل على معرّف الموارد المنتظم لمساحة الاسم.

`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` باستخدام معرّف الموارد الموحّد المحدّد
`getNamespace(prefix, uri)`	`Namespace`	لإنشاء `Namespace` باستخدام البادئة وعنوان URL المحدَّدين
`getNoNamespace()`	`Namespace`	ينشئ `Namespace` يمثّل عدم توفّر مساحة اسم حقيقية.
`getPrettyFormat()`	`Format`	لإنشاء عنصر `Format` لإخراج مستند XML يمكن لشخص عادي قراءته.
`getRawFormat()`	`Format`	لإنشاء عنصر `Format` لإخراج مستند XML أولي
`getXmlNamespace()`	`Namespace`	تُنشئ `Namespace` باستخدام البادئة العادية `xml`.
`parse(xml)`	`Document`	لإنشاء `Document` من ملف XML معيّن، بدون التحقّق من صحة ملف XML