عنصر سؤال يسمح للمجيب بتحديد خيار واحد من تسلسل مرقم لأزرار الاختيار. يمكن الوصول إلى العناصر أو إنشاؤها من "Form
". عند استخدامها في اختبار،
يتم تقييم هذه العناصر.
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
createResponse(response) | ItemResponse | ينشئ عنصر ItemResponse جديدًا لعنصر المقياس هذا. |
duplicate() | ScaleItem | لإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج |
getGeneralFeedback() | QuizFeedback | تعرض الملاحظات التي يتم عرضها للمستجيبين عند الرد على سؤال يمكن وضع درجات له. |
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
خارج الحدود المسموح بها للعنصر.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
: الملاحظات، إن توفّرت
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
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
.
تعرض استثناء برمجة نصية إذا كانت القيم المحددة خارج الحدود المسموح بها. ويتم اقتطاع الأرقام العشرية إلى العدد الصحيح السابق.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
lower | Integer | الحد الأدنى الجديد |
upper | Integer | الحد الأعلى الجديد |
استرجاع الكرة
ScaleItem
— جهاز ScaleItem
هذا للسلاسل
الرميات
Error
: إذا كان الحد الأدنى أو الأعلى غير صالح
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
تعيين الملاحظات التي سيتم عرضها للمستجيبين عند الرد على سؤال يمكن وضع درجات عليه ليس له إجابة صحيحة أو غير صحيحة (مثل الأسئلة التي تتطلب وضع درجات يدوي).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
feedback | QuizFeedback | الملاحظات الجديدة |
استرجاع الكرة
ScaleItem
— جهاز ScaleItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
استرجاع الكرة
ScaleItem
— جهاز ScaleItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLabels(lower, upper)
لضبط تصنيفات للحدود الدنيا والأعلى للمقياس.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
lower | String | التسمية الجديدة للحدّ الأدنى |
upper | String | التسمية الجديدة للحد الأعلى |
استرجاع الكرة
ScaleItem
— جهاز ScaleItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
لضبط عدد النقاط التي يستحقها العنصر القابل لوضع درجات. القيمة التلقائية للعناصر الجديدة هي 0.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
points | Integer | عدد النقاط التي يستحقها عنصر السؤال |
استرجاع الكرة
ScaleItem
— جهاز ScaleItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تحدِّد هذه السياسة ما إذا كان على المجيب الإجابة عن السؤال.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان يجب على المجيب الإجابة على السؤال |
استرجاع الكرة
ScaleItem
- العنصر الحالي (للسلاسل)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
استرجاع الكرة
ScaleItem
— جهاز ScaleItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms