خيار واحد مرتبط بنوع Item
يتيح خيارات، مثل CheckboxItem
أو ListItem
أو MultipleChoiceItem
.
// Create a new form and add a multiple-choice item. var form = FormApp.create('Form Name'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE), item.createChoice('Dogs', FormApp.PageNavigationType.RESTART) ]); // Add another page because navigation has no effect on the last page. form.addPageBreakItem().setTitle('You chose well!'); // Log the navigation types that each choice results in. var choices = item.getChoices(); for (var i = 0; i < choices.length; i++) { Logger.log('If the respondent chooses "%s", the form will %s.', choices[i].getValue(), choices[i].getPageNavigationType()); }
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
getGotoPage() | PageBreakItem | يتم ضبط PageBreakItem كوجهة GO_TO_PAGE
إذا اختار المجيب هذا الاختيار وأكمل الصفحة الحالية. |
getPageNavigationType() | PageNavigationType | الحصول على PageNavigationType التي تحدث إذا حدّد المجيب هذا الاختيار وأكمل الصفحة الحالية. |
getValue() | String | الحصول على قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج. |
isCorrectAnswer() | Boolean | لمعرفة ما إذا كان الخيار إجابة صحيحة عن السؤال. |
الوثائق التفصيلية
getGotoPage()
يتم ضبط PageBreakItem
كوجهة GO_TO_PAGE
إذا اختار المجيب هذا الاختيار وأكمل الصفحة الحالية. لا تنطبق هذه الطريقة إلا على الخيارات المرتبطة بـ MultipleChoiceItems
، أما في الخيارات الأخرى، فإنها تعرض null
.
استرجاع الكرة
PageBreakItem
: وجهة GO_TO_PAGE
لهذا الخيار أو null
في حال عدم توفّر الوجهة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getValue()
الحصول على قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج.
استرجاع الكرة
String
— قيمة الخيار
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isCorrectAnswer()
لمعرفة ما إذا كان الخيار إجابة صحيحة عن السؤال. لا تنطبق هذه الطريقة إلا على الأسئلة التي تشكل جزءًا من الاختبار؛ أما بالنسبة للنماذج التي ليست عبارة عن اختبار، فتكون "خطأ".
استرجاع الكرة
Boolean
— ما إذا كان الاختيار إجابة صحيحة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms