Class MultipleChoiceItem

MultipleChoiceItem

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

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 إذا كان العنصر يحتوي على القيمة "other" خِيَارْ 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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