Class ScaleItem

المقياسالعنصر

عنصر سؤال يسمح للمستجيب باختيار خيار واحد من تسلسل مرقّم لأزرار radio. يمكن الوصول إلى العناصر أو إنشاؤها من 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تعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
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 خارج الحدود المحدّدة للعنصر.

المعلمات

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

الإرجاع

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

تحصل على نوع العنصر الذي يتم تمثيله كـ 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 تلقائيًا.

يُرسِل استثناءً للنص البرمجي إذا كانت القيم المقدَّمة خارج الحدود المسموح بها. يتم اقتطاع الكسور العشرية إلى العدد الصحيح السابق.

المعلمات

الاسمالنوعالوصف
lowerIntegerالحد الأدنى الجديد
upperIntegerالحدّ الأقصى الجديد

الإرجاع

ScaleItem — هذا ScaleItem، لإنشاء سلسلة

عمليات الرمي

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

التفويض

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

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

setGeneralFeedback(feedback)

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

المعلمات

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

الإرجاع

ScaleItem — هذا ScaleItem، لإنشاء سلسلة

التفويض

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

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

setHelpText(text)

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

المعلمات

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

الإرجاع

ScaleItem — هذا ScaleItem، لإنشاء سلسلة

التفويض

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

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

setLabels(lower, upper)

تُستخدَم لضبط تصنيفات للحدود الدنيا والعليا للمقياس.

المعلمات

الاسمالنوعالوصف
lowerStringالتصنيف الجديد للحدّ الأدنى
upperStringالتصنيف الجديد للحدّ الأقصى

الإرجاع

ScaleItem — هذا ScaleItem، لإنشاء سلسلة

التفويض

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

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

setPoints(points)

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

المعلمات

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

الإرجاع

ScaleItem — هذا ScaleItem، لإنشاء سلسلة

التفويض

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

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

setRequired(enabled)

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

المعلمات

الاسمالنوعالوصف
enabledBooleanما إذا كان على المجيب الإجابة عن السؤال

الإرجاع

ScaleItem: العنصر الحالي (للتسلسل)

التفويض

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

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

setTitle(title)

لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

المعلمات

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

الإرجاع

ScaleItem — هذا ScaleItem، لإنشاء سلسلة

التفويض

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

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