Interface Item

السلعة

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

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

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

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

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var 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لعرض العنصر كعنصر نصي فقرة.
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

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