Class MultipleChoiceItem

عنصرخياراتمتعددة

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

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([item.createChoice('Cats'), item.createChoice('Dogs')])
    .showOtherOption(true);

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
createChoice(value)Choiceتنشئ هذه الطريقة خيارًا جديدًا.
createChoice(value, isCorrect)Choiceتنشئ هذه الطريقة خيارًا جديدًا.
createChoice(value, navigationItem)Choiceتنشئ هذه السمة خيارًا جديدًا يتضمّن خيارًا للتنقل بين الصفحات ينتقل إلى عنصر فاصل صفحات معيّن.
createChoice(value, navigationType)Choiceتنشئ هذه السمة خيارًا جديدًا يتضمّن خيارًا للتنقّل بين الصفحات.
createResponse(response)ItemResponseتُنشئ هذه السمة ItemResponse جديدًا لعنصر الاختيار من متعدد هذا.
duplicate()MultipleChoiceItemينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.
getChoices()Choice[]تعرض هذه السمة جميع خيارات أحد العناصر.
getFeedbackForCorrect()QuizFeedback|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح.
getFeedbackForIncorrect()QuizFeedback|nullتعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
getHelpText()Stringتعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerتعرض هذه الطريقة المعرّف الفريد للعنصر.
getIndex()Integerتعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج.
getPoints()Integerتعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم.
getTitle()Stringتعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).
getType()ItemTypeتعرض هذه السمة نوع العنصر، ويتم تمثيله كـ ItemType.
hasOtherOption()Booleanتحدّد ما إذا كان العنصر يتضمّن خيار "غير ذلك".
isRequired()Booleanتحدّد ما إذا كان يجب على المستجيب الإجابة عن السؤال.
setChoiceValues(values)MultipleChoiceItemتضبط هذه السمة خيارات عنصر من مصفوفة سلاسل.
setChoices(choices)MultipleChoiceItemتضبط هذه السمة مصفوفة من الخيارات لعنصر معيّن.
setFeedbackForCorrect(feedback)MultipleChoiceItemتضبط هذه السمة الملاحظات التي ستظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح.
setFeedbackForIncorrect(feedback)MultipleChoiceItemتضبط هذه السمة الملاحظات التي ستظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
setHelpText(text)MultipleChoiceItemتضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)MultipleChoiceItemتضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم.
setRequired(enabled)MultipleChoiceItemتضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال.
setTitle(title)MultipleChoiceItemتضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).
showOtherOption(enabled)MultipleChoiceItemتضبط هذه السمة ما إذا كان العنصر يتضمّن خيار "غير ذلك".

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

createChoice(value)

تنشئ هذه الطريقة خيارًا جديدًا.

المعلمات

الاسمالنوعالوصف
valueStringقيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج

الإرجاع

‫Choice — الخيار الجديد

التفويض

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

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

createChoice(value, isCorrect)

تنشئ هذه الطريقة خيارًا جديدًا.

المعلمات

الاسمالنوعالوصف
valueStringقيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج
isCorrectBooleanما إذا كان الخيار هو الإجابة الصحيحة

الإرجاع

‫Choice — الخيار الجديد

التفويض

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

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

createChoice(value, navigationItem)

تنشئ هذه السمة خيارًا جديدًا يتضمّن خيارًا للتنقل بين الصفحات ينتقل إلى عنصر فاصل صفحات معيّن. وهذا يعادل createChoice(value, navigationType) مع ضبط navigationType على FormApp.PageNavigationType.GO_TO_PAGE. لا يمكن دمج الخيارات التي تستخدم التنقّل بين الصفحات في العنصر نفسه مع الخيارات التي لا تستخدم التنقّل بين الصفحات.

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

المعلمات

الاسمالنوعالوصف
valueStringقيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج
navigationItemPageBreakItemالعنصر المطلوب الانتقال إليه

الإرجاع

‫Choice — الخيار الجديد

التفويض

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

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

createChoice(value, navigationType)

تنشئ هذه السمة خيارًا جديدًا يتضمّن خيارًا للتنقّل بين الصفحات. لا يمكن الجمع بين الخيارات التي تستخدم التنقّل بين الصفحات والخيار الذي لا يستخدم التنقّل بين الصفحات في العنصر نفسه.

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

المعلمات

الاسمالنوعالوصف
valueStringقيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج
navigationTypePageNavigationTypeنوع التنقّل الخاص بخيار الرد

الإرجاع

‫Choice — الخيار الجديد

التفويض

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

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

createResponse(response)

تُنشئ هذه السمة ItemResponse جديدًا لعنصر الاختيار من متعدد هذا. يتم عرض استثناء إذا كانت الوسيطة response لا تتطابق مع خيار صالح لهذا العنصر، ما لم يتم ضبط showOtherOption(enabled) على true.

المعلمات

الاسمالنوعالوصف
responseStringإجابة صالحة لهذا السؤال ذي الخيارات المتعدّدة

الإرجاع

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

التفويض

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

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

duplicate()

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

الإرجاع

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

التفويض

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

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

getChoices()

تعرض هذه السمة جميع خيارات أحد العناصر.

الإرجاع

‫Choice[]: مصفوفة من الخيارات

التفويض

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

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

getFeedbackForCorrect()

تعرض هذه السمة الملاحظات التي تظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح.

الإرجاع

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

التفويض

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

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

getFeedbackForIncorrect()

تعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.

الإرجاع

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

getPoints()

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

الإرجاع

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

hasOtherOption()

تحدّد ما إذا كان العنصر يتضمّن خيار "غير ذلك".

الإرجاع

‫Boolean — true إذا كان العنصر يتضمّن الخيار "غير ذلك"، false إذا لم يكن كذلك

التفويض

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

  • 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

setChoiceValues(values)

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

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

المعلمات

الاسمالنوعالوصف
valuesString[]مصفوفة قيم الخيارات التي يراها المجيبون كتصنيفات عند عرض النموذج

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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

setChoices(choices)

تضبط هذه السمة مصفوفة من الخيارات لعنصر معيّن. يُطلق استثناءً إذا كانت المصفوفة المحدّدة فارغة أو تحتوي على عنصر null. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

المعلمات

الاسمالنوعالوصف
choicesChoice[]مصفوفة من الخيارات

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

الرميات

Error: إذا كانت المصفوفة المحدّدة هي null أو فارغة أو تحتوي على عنصر null

التفويض

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

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

setFeedbackForCorrect(feedback)

تضبط هذه السمة الملاحظات التي ستظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(),
);

المعلمات

الاسمالنوعالوصف
feedbackQuizFeedbackالملاحظات الجديدة ستؤدي القيمة الفارغة إلى محو الملاحظات.

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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

setFeedbackForIncorrect(feedback)

تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.

المعلمات

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

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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

setHelpText(text)

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

المعلمات

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

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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

setPoints(points)

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

المعلمات

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

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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

setRequired(enabled)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setTitle(title)

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

المعلمات

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

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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

showOtherOption(enabled)

تضبط هذه السمة ما إذا كان العنصر يتضمّن خيار "غير ذلك". القيمة التلقائية لـ CheckboxItem أو MultipleChoiceItem جديدة هي false.

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان العنصر يتضمّن خيار "غير ذلك"، false إذا لم يكن كذلك

الإرجاع

‫MultipleChoiceItem — هذا MultipleChoiceItem، للسلسلة

التفويض

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

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