تمت ترجمة هذه الصفحة بواسطة 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` بالاسم المحدّد ومساحة الاسم التي تكون ثانوية مباشرة عقدة `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`	للحصول على معرّف الموارد المنتظم (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.