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