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