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	تعرِض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون بشكل صحيح عن سؤال.
getFeedbackForIncorrect()	QuizFeedback	تعرِض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون بشكل غير صحيح عن سؤال.
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)

لإنشاء خيار جديد.

المعلَمات

الاسم	النوع	الوصف
value	String	قيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج

الإرجاع

Choice - الخيار الجديد

التفويض

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

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

---

createChoice(value, isCorrect)

لإنشاء خيار جديد.

المعلَمات

الاسم	النوع	الوصف
value	String	قيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج
isCorrect	Boolean	ما إذا كان الخيار هو إجابة صحيحة

الإرجاع

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. لا يمكن دمج الخيارات التي تستخدِم التنقل في الصفحة في العنصر نفسه مع الخيارات التي لا تستخدِم التنقل في الصفحة.

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

المعلَمات

الاسم	النوع	الوصف
value	String	قيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج
navigationItem	PageBreakItem	العنصر المطلوب الانتقال إليه

الإرجاع

Choice - الخيار الجديد

التفويض

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

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

---

createChoice(value, navigationType)

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

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

المعلَمات

الاسم	النوع	الوصف
value	String	قيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج
navigationType	PageNavigationType	نوع التنقّل في الخيار

الإرجاع

Choice - الخيار الجديد

التفويض

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

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

---

createResponse(response)

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

المعلَمات

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

الإرجاع

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: الملاحظات، إن توفّرت.

التفويض

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

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

---

getFeedbackForIncorrect()

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

الإرجاع

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

---

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']);

المعلَمات

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

الإرجاع

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')]);

المعلَمات

الاسم	النوع	الوصف
choices	Choice[]	صفيف من الخيارات

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
feedback	QuizFeedback	الملاحظات الجديدة. ستؤدي القيمة الخالية إلى محو الملاحظات.

الإرجاع

MultipleChoiceItem — هذا الرمز MultipleChoiceItem، لإنشاء سلسلة

التفويض

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

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

---

setFeedbackForIncorrect(feedback)

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

المعلَمات

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

الإرجاع

MultipleChoiceItem — هذا الرمز MultipleChoiceItem، لإنشاء سلسلة

التفويض

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

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

---

setHelpText(text)

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

المعلَمات

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

الإرجاع

MultipleChoiceItem — هذا الرمز MultipleChoiceItem، لإنشاء سلسلة

التفويض

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

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

---

setPoints(points)

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

المعلَمات

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

الإرجاع

MultipleChoiceItem — هذا الرمز MultipleChoiceItem، لإنشاء سلسلة

التفويض

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

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

---

setRequired(enabled)

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

المعلَمات

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

الإرجاع

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

التفويض

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

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

---

setTitle(title)

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

المعلَمات

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

الإرجاع

MultipleChoiceItem — هذا الرمز MultipleChoiceItem، لإنشاء سلسلة

التفويض

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

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

---

showOtherOption(enabled)

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

المعلَمات

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

الإرجاع

MultipleChoiceItem — هذا الرمز MultipleChoiceItem، لإنشاء سلسلة

التفويض

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

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