Class ScaleItem

ScaleItem

عنصر سؤال يتيح للمستجيب اختيار خيار واحد من تسلسل مرقّم لأزرار اختيار. يمكن الوصول إلى العناصر أو إنشاؤها من Form. وعند استخدامها في اختبار، يتم تقييم هذه العناصر.

// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
createResponse(response)	ItemResponse	تُنشئ هذه السمة ItemResponse جديدًا لعنصر المقياس هذا.
duplicate()	ScaleItem	ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.
getGeneralFeedback()	QuizFeedback|null	تعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
getHelpText()	String	تعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()	Integer	تعرض هذه الطريقة المعرّف الفريد للعنصر.
getIndex()	Integer	تعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج.
getLeftLabel()	String	تعرض هذه السمة تصنيف الحدّ الأدنى للمقياس، إذا كان متوفّرًا.
getLowerBound()	Integer	تعرض هذه السمة الحدّ الأدنى للمقياس.
getPoints()	Integer	تعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم.
getRightLabel()	String	تعرض هذه السمة تصنيف الحدّ الأعلى للمقياس، إن وُجد.
getTitle()	String	تعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).
getType()	ItemType	تعرض هذه السمة نوع العنصر، ويتم تمثيله كـ ItemType.
getUpperBound()	Integer	تعرض هذه السمة الحدّ الأعلى للمقياس.
isRequired()	Boolean	تحدّد ما إذا كان يجب على المستجيب الإجابة عن السؤال.
setBounds(lower, upper)	ScaleItem	تضبط هذه السمة الحدّين الأدنى والأعلى للمقياس.
setGeneralFeedback(feedback)	ScaleItem	تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عند الإجابة عن سؤال قابل للتقييم لا يتضمّن إجابة صحيحة أو غير صحيحة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)	ScaleItem	تضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setLabels(lower, upper)	ScaleItem	تضبط هذه السمة تصنيفات للحدّين الأدنى والأعلى للمقياس.
setPoints(points)	ScaleItem	تضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم.
setRequired(enabled)	ScaleItem	تضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال.
setTitle(title)	ScaleItem	تضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).

مستندات تفصيلية

createResponse(response)

تُنشئ هذه السمة ItemResponse جديدًا لعنصر المقياس هذا. يتم عرض استثناء إذا كانت الوسيطة response خارج الحدود المحدّدة للعنصر.

المَعلمات

الاسم	النوع	الوصف
response	Integer	إجابة قيمة لهذا العنصر من المقياس

الإرجاع

‫ItemResponse: استجابة العنصر

التفويض

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

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

---

duplicate()

ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.

الإرجاع

‫ScaleItem: نسخة مكرّرة من ScaleItem، لتسلسل العمليات

التفويض

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

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

---

getGeneralFeedback()

تعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.

الإرجاع

QuizFeedback|null: الملاحظات، إن وُجدت.

التفويض

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

• 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

---

getLeftLabel()

تعرض هذه السمة تصنيف الحدّ الأدنى للمقياس، إذا كان متوفّرًا.

الإرجاع

‫String: تصنيف الحدّ الأدنى للمقياس

التفويض

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

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

---

getLowerBound()

تعرض هذه السمة الحدّ الأدنى للمقياس.

الإرجاع

Integer: الحدّ الأدنى للمقياس

التفويض

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

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

---

getPoints()

تعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم.

الإرجاع

Integer: عدد النقاط التي يستحقها السؤال

التفويض

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

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

---

getRightLabel()

تعرض هذه السمة تصنيف الحدّ الأعلى للمقياس، إن وُجد.

الإرجاع

String: تصنيف الحدّ الأعلى للمقياس

التفويض

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

• 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

---

getUpperBound()

تعرض هذه السمة الحدّ الأعلى للمقياس.

الإرجاع

Integer: الحدّ الأعلى للمقياس

التفويض

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

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

---

isRequired()

تحدّد ما إذا كان يجب على المستجيب الإجابة عن السؤال.

الإرجاع

Boolean: ما إذا كان على المشارك الإجابة عن السؤال

التفويض

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

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

---

setBounds(lower, upper)

تضبط هذه السمة الحدّين الأدنى والأعلى للمقياس. يجب أن يكون الحد الأدنى 0 أو 1. يجب أن يكون الحد الأعلى بين 3 و10، مع تضمين القيمتين. يكون الحد الأدنى للمقياس الجديد 1 والحد الأقصى 5 تلقائيًا.

يؤدي إلى ظهور خطأ في البرمجة النصية إذا كانت القيم المحدّدة خارج الحدود المسموح بها. يتم اقتطاع الأرقام العشرية إلى العدد الصحيح السابق.

المَعلمات

الاسم	النوع	الوصف
lower	Integer	الحد الأدنى الجديد
upper	Integer	الحدّ الأعلى الجديد

الإرجاع

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

عمليات الطرح

Error: إذا كان الحد الأدنى أو الأقصى غير صالح

التفويض

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

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

---

setGeneralFeedback(feedback)

تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عند الإجابة عن سؤال قابل للتقييم لا يتضمّن إجابة صحيحة أو غير صحيحة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).

المَعلمات

الاسم	النوع	الوصف
feedback	QuizFeedback	الملاحظات الجديدة

الإرجاع

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

التفويض

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

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

---

setHelpText(text)

تضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setLabels(lower, upper)

تضبط هذه السمة تصنيفات للحدّين الأدنى والأعلى للمقياس.

المَعلمات

الاسم	النوع	الوصف
lower	String	التصنيف الجديد للحد الأدنى
upper	String	التصنيف الجديد للحدّ الأعلى

الإرجاع

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

التفويض

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

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

---

setPoints(points)

تضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم. القيمة التلقائية للعناصر الجديدة هي 0.

المَعلمات

الاسم	النوع	الوصف
points	Integer	عدد النقاط التي يستحقها سؤال

الإرجاع

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

التفويض

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

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

---

setRequired(enabled)

تضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال.

المَعلمات

الاسم	النوع	الوصف
enabled	Boolean	ما إذا كان على المشارك الإجابة عن السؤال

الإرجاع

‫ScaleItem: العنصر الحالي (لربط السلسلة)

التفويض

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

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

---

setTitle(title)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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