عنصر سؤال يتيح للمجيب اختيار خيار واحد من قائمة أزرار اختيار أو حقل "غير ذلك" اختياري. يمكن الوصول إلى العناصر أو إنشاؤها من 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);
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
create | Choice | تنشئ هذه الطريقة خيارًا جديدًا. |
create | Choice | تنشئ هذه الطريقة خيارًا جديدًا. |
create | Choice | تنشئ هذه السمة خيارًا جديدًا يتضمّن خيارًا للتنقل بين الصفحات ينتقل إلى عنصر فاصل صفحات معيّن. |
create | Choice | تنشئ هذه السمة خيارًا جديدًا يتضمّن خيارًا للتنقّل بين الصفحات. |
create | Item | تُنشئ هذه السمة Item جديدًا لعنصر الاختيار من متعدد هذا. |
duplicate() | Multiple | ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج. |
get | Choice[] | تعرض هذه الطريقة جميع خيارات أحد العناصر. |
get | Quiz | تعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون بشكل صحيح عن سؤال. |
get | Quiz | تعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح. |
get | String | تعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل Image وPage وSection). |
get | Integer | تعرض هذه الطريقة المعرّف الفريد للعنصر. |
get | Integer | تعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج. |
get | Integer | تعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم. |
get | String | تعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة Section). |
get | Item | تعرض هذه السمة نوع العنصر، ويتم تمثيله كـ Item. |
has | Boolean | تحدّد ما إذا كان العنصر يتضمّن خيار "غير ذلك". |
is | Boolean | تحدّد ما إذا كان يجب على المستجيب الإجابة عن السؤال. |
set | Multiple | تضبط هذه السمة خيارات عنصر من مصفوفة سلاسل. |
set | Multiple | تضبط هذه السمة مصفوفة من الخيارات لعنصر معيّن. |
set | Multiple | تضبط هذه السمة الملاحظات التي ستظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح. |
set | Multiple | تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح. |
set | Multiple | تضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل Image وPage وSection). |
set | Multiple | تضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم. |
set | Multiple | تضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال. |
set | Multiple | تضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة Section). |
show | Multiple | تضبط هذه السمة ما إذا كان العنصر يتضمّن خيار "غير ذلك". |
مستندات تفصيلية
createChoice(value)
تنشئ هذه الطريقة خيارًا جديدًا.
المَعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | قيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج |
الإرجاع
Choice — الخيار الجديد
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
createChoice(value, isCorrect)
تنشئ هذه الطريقة خيارًا جديدًا.
المَعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | قيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج |
is | 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. لا يمكن الجمع بين الخيارات التي تستخدم التنقّل بين الصفحات في العنصر نفسه مع الخيارات التي لا تستخدم التنقّل بين الصفحات.
يحدث التنقّل في الصفحة بعد أن يكمل المجيب صفحة تتضمّن الخيار، وفقط إذا اختار المجيب هذا الخيار. إذا اختار المجيب خيارات متعددة تتضمّن تعليمات تنقّل بين الصفحات على الصفحة نفسها، لن يكون لأي خيار تنقّل أي تأثير سوى خيار التنقّل الأخير. لا يؤثر التنقّل في الصفحة أيضًا في الصفحة الأخيرة من النموذج.
ملاحظة: يؤدي استخدام ميزة "التنقل في الصفحة" في عنصر ما إلى ترميز التوجيه بشكل ثابت، ما يعني أنّه لا يجب استخدام showOtherOption(true) في الوقت نفسه.
المَعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | قيمة الخيار، وهي التصنيف الذي يراه المجيبون عند عرض النموذج |
navigation | Page | العنصر المطلوب الانتقال إليه |
الإرجاع
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()
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()
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().setText('Dogs rule, cats drool.').build(), );
المَعلمات
| الاسم | النوع | الوصف |
|---|---|---|
feedback | Quiz | الملاحظات الجديدة ستؤدي القيمة الفارغة إلى محو الملاحظات. |
الإرجاع
MultipleChoiceItem — هذا MultipleChoiceItem، للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
المَعلمات
| الاسم | النوع | الوصف |
|---|---|---|
feedback | Quiz | الملاحظات الجديدة |
الإرجاع
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