Interface Item

السلعة

عنصر نموذج عام يحتوي على خصائص مشتركة بين جميع العناصر، مثل العنوان ونص المساعدة. يمكن الوصول إلى العناصر أو إنشاؤها من Form.

لإجراء عمليات على سمات خاصة بنوع معيّن، استخدِم getType() للتحقّق من ItemType الخاص بالعنصر، ثم حوِّل العنصر إلى الفئة المناسبة باستخدام طريقة مثل asCheckboxItem(). 

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const textItem = item.asTextItem();
  textItem.setRequired(false);
}

تنفيذ الفئات

الاسموصف قصير

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
asCheckboxGridItem()CheckboxGridItemتعرض هذه السمة العنصر كعنصر في شبكة مربّعات الاختيار.
asCheckboxItem()CheckboxItemتعرض العنصر كعنصر مربّع اختيار.
asDateItem()DateItemتعرض هذه الدالة العنصر كتاريخ.
asDateTimeItem()DateTimeItemتعرض العنصر كعنصر تاريخ ووقت.
asDurationItem()DurationItemتعرض هذه السمة العنصر كعنصر مدة.
asGridItem()GridItemتعرض هذه السمة المنتج كعنصر في شبكة.
asImageItem()ImageItemتعرض هذه السمة العنصر كعنصر صورة.
asListItem()ListItemتعرض السلعة كعنصر قائمة.
asMultipleChoiceItem()MultipleChoiceItemتعرض هذه الدالة العنصر كعنصر اختيار من متعدد.
asPageBreakItem()PageBreakItemتعرض هذه السمة السلعة كعنصر فاصل صفحات.
asParagraphTextItem()ParagraphTextItemتعرض هذه السمة العنصر كعنصر نصي فقرة.
asRatingItem()RatingItemتعرض هذه السمة العنصر كعنصر تقييم.
asScaleItem()ScaleItemتعرض هذه الدالة العنصر كعنصر مقياس.
asSectionHeaderItem()SectionHeaderItemتعرض العنصر كعنصر عنوان قسم.
asTextItem()TextItemتعرض السلعة كسلعة نصية.
asTimeItem()TimeItemتعرض هذه الدالة العنصر كعنصر زمني.
asVideoItem()VideoItemتعرض هذه السمة السلعة كسلعة فيديو.
duplicate()Itemينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.
getHelpText()Stringتعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerتعرض هذه الطريقة المعرّف الفريد للعنصر.
getIndex()Integerتعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج.
getTitle()Stringتعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).
getType()ItemTypeتعرض هذه السمة نوع العنصر، ويتم تمثيله كـ ItemType.
setHelpText(text)Itemتضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setTitle(title)Itemتضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).

مستندات تفصيلية

asCheckboxGridItem()

تعرض هذه السمة العنصر كعنصر في شبكة مربّعات الاختيار. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType CHECKBOX_GRID.

الإرجاع

CheckboxGridItem: عنصر شبكة مربّعات الاختيار

عمليات الطرح

Error — إذا لم يكن العنصر عنصرًا في شبكة مربّعات الاختيار

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asCheckboxItem()

تعرض العنصر كعنصر مربّع اختيار. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType CHECKBOX.

الإرجاع

CheckboxItem: عنصر مربّع الاختيار

عمليات الطرح

Error — إذا لم يكن العنصر عنصر مربّع اختيار

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asDateItem()

تعرض هذه الدالة العنصر كتاريخ. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType DATE.

الإرجاع

DateItem: عنصر التاريخ

عمليات الطرح

Error: إذا لم يكن العنصر عنصر تاريخ

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asDateTimeItem()

تعرض العنصر كعنصر تاريخ ووقت. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType DATETIME.

الإرجاع

‫DateTimeItem: عنصر التاريخ والوقت

عمليات الطرح

Error: إذا لم يكن العنصر عنصرًا يتضمّن تاريخًا ووقتًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asDurationItem()

تعرض هذه السمة العنصر كعنصر مدة. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType DURATION.

الإرجاع

‫DurationItem: عنصر المدة

عمليات الطرح

Error — إذا لم يكن العنصر عنصرًا مدته محددة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asGridItem()

تعرض هذه السمة المنتج كعنصر في شبكة. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType GRID.

الإرجاع

GridItem: عنصر الشبكة

عمليات الطرح

Error: إذا لم يكن العنصر عنصرًا في شبكة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asImageItem()

تعرض هذه السمة العنصر كعنصر صورة. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType IMAGE.

الإرجاع

ImageItem: عنصر الصورة

عمليات الطرح

‫Error: إذا كان العنصر ليس عنصر صورة

asListItem()

تعرض السلعة كعنصر قائمة. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType LIST.

الإرجاع

ListItem: عنصر القائمة

عمليات الطرح

Error: إذا لم يكن العنصر عنصر قائمة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asMultipleChoiceItem()

تعرض هذه الدالة العنصر كعنصر اختيار من متعدد. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType MULTIPLE_CHOICE.

الإرجاع

MultipleChoiceItem: عنصر الاختيار من متعدد

عمليات الطرح

Error: إذا لم يكن العنصر من عناصر الاختيار من متعدد

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asPageBreakItem()

تعرض هذه السمة السلعة كعنصر فاصل صفحات. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType PAGE_BREAK.

الإرجاع

‫PageBreakItem: عنصر فاصل الصفحات

عمليات الطرح

‫Error: إذا لم يكن العنصر عنصر فاصل صفحات

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asParagraphTextItem()

تعرض هذه السمة العنصر كعنصر نصي فقرة. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType PARAGRAPH_TEXT.

الإرجاع

ParagraphTextItem: عنصر نص الفقرة

عمليات الطرح

Error: إذا لم يكن العنصر عنصر نص فقرة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asRatingItem()

تعرض هذه السمة العنصر كعنصر تقييم. يطرح ScriptingException إذا لم يكن ItemType RATING. 

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

الإرجاع

استبدِل RatingItem بعنصر التقييم.

عمليات الطرح

Error: إذا لم يكن العنصر عنصر تقييم

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asScaleItem()

تعرض هذه الدالة العنصر كعنصر مقياس. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType SCALE.

الإرجاع

ScaleItem: عنصر المقياس

عمليات الطرح

Error: إذا لم يكن العنصر قابلاً للتوسيع

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asSectionHeaderItem()

تعرض العنصر كعنصر عنوان قسم. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType SECTION_HEADER.

الإرجاع

‫SectionHeaderItem: عنصر عنوان القسم

عمليات الطرح

Error: إذا لم يكن العنصر عنصر عنوان قسم

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asTextItem()

تعرض السلعة كسلعة نصية. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType TEXT.

الإرجاع

TextItem: عنصر النص

عمليات الطرح

‫Error: إذا كان العنصر ليس عنصرًا نصيًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asTimeItem()

تعرض هذه الدالة العنصر كعنصر زمني. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType TIME.

الإرجاع

‫TimeItem: عنصر الوقت

عمليات الطرح

Error: إذا لم يكن العنصر عنصرًا زمنيًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asVideoItem()

تعرض هذه السمة السلعة كسلعة فيديو. يُطلق هذا الإجراء خطأ في البرمجة النصية إذا لم يكن ItemType VIDEO.

الإرجاع

‫VideoItem: عنصر الفيديو

عمليات الطرح

Error: إذا كان العنصر ليس عنصر فيديو

duplicate()

ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.

الإرجاع

‫Item: نسخة مكرّرة من Item، لتسلسل العمليات

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

تعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

الإرجاع

String — نص المساعدة أو نص الوصف الخاص بالعنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

تعرض هذه الطريقة المعرّف الفريد للعنصر.

الإرجاع

Integer: معرّف السلعة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

تعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج.

الإرجاع

‫Integer: فهرس العنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

تعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).

الإرجاع

String: عنوان السلعة أو نص العنوان

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

تعرض هذه السمة نوع العنصر، ويتم تمثيله كـ ItemType.

الإرجاع

‫ItemType: نوع العنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

تضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

المعلمات

الاسمالنوعالوصف
textStringنص المساعدة الجديد

الإرجاع

‫Item — هذا Item، للسلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

تضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).

المعلمات

الاسمالنوعالوصف
titleStringالعنوان الجديد أو نص العنوان

الإرجاع

‫Item — هذا Item، للسلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms