تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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