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

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setTitle(title)

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

المعلمات

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

الإرجاع

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

التفويض

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

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