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).

المَعلمات

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

استرجاع الكرة

Item — جهاز Item هذا للسلاسل

التفويض

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

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

setTitle(title)

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

المَعلمات

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

استرجاع الكرة

Item — جهاز Item هذا للسلاسل

التفويض

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

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