عنصر سؤال يسمح للمجيب بتحديد خيار واحد من قائمة أزرار الاختيار أو حقل "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 | تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "other". |
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)
ينشئ خيارًا جديدًا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
value | String | قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج |
استرجاع الكرة
Choice
— الخيار الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value, isCorrect)
ينشئ خيارًا جديدًا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
. لا يمكن دمج الخيارات التي تستخدم التنقّل
في الصفحة في العنصر نفسه مع الخيارات التي لا تستخدم التنقّل في الصفحة.
يحدث التنقل في الصفحة بعد إكمال المستجيب للصفحة التي تحتوي على الخيار، وفقط إذا حدد المستجيب هذا الخيار. إذا اختار المستجيب خيارات متعددة مع تعليمات التنقل في الصفحة على نفس الصفحة، فإن خيار التنقل الأخير فقط هو الذي يكون له أي تأثير. لا يؤثر التنقّل في الصفحة أيضًا في الصفحة الأخيرة من النموذج.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
value | String | قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج |
navigationItem | PageBreakItem | العنصر للانتقال إليه |
استرجاع الكرة
Choice
— الخيار الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
ينشئ عنصر ItemResponse
جديدًا لهذا العنصر المتعدّد الخيارات. توفّر هذه الدالة استثناءً إذا لم تتطابق الوسيطة
response
مع اختيار صالح لهذا العنصر، ما لم يتم ضبط السمة showOtherOption(enabled)
على true
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
: الملاحظات، إن توفّرت
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
hasOtherOption()
تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "other".
استرجاع الكرة
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. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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') ]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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());
المَعلمات
الاسم | Type | الوصف |
---|---|---|
feedback | QuizFeedback | الملاحظات الجديدة. سيؤدي استخدام قيمة فارغة إلى محو الملاحظات. |
استرجاع الكرة
MultipleChoiceItem
— جهاز MultipleChoiceItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
ضبط الملاحظات بحيث يتم عرضها للمجيبين عندما يجيبون بشكل غير صحيح على سؤال.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
feedback | QuizFeedback | الملاحظات الجديدة |
استرجاع الكرة
MultipleChoiceItem
— جهاز MultipleChoiceItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
استرجاع الكرة
MultipleChoiceItem
— جهاز MultipleChoiceItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
لضبط عدد النقاط التي يستحقها العنصر القابل لوضع درجات. القيمة التلقائية للعناصر الجديدة هي 0.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
points | Integer | عدد النقاط التي يستحقها عنصر السؤال |
استرجاع الكرة
MultipleChoiceItem
— جهاز MultipleChoiceItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تحدِّد هذه السياسة ما إذا كان على المجيب الإجابة عن السؤال.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان يجب على المجيب الإجابة على السؤال |
استرجاع الكرة
MultipleChoiceItem
- العنصر الحالي (للسلاسل)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
استرجاع الكرة
MultipleChoiceItem
— جهاز MultipleChoiceItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
لتحديد ما إذا كان العنصر يحتوي على خيار "غير ذلك". ويكون الإعداد التلقائي لـ CheckboxItem
أو MultipleChoiceItem
الجديد هو false
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | true إذا كان العنصر يتضمن الخيار "غير ذلك"، وfalse إذا لم يكن الخيار "غير ذلك" |
استرجاع الكرة
MultipleChoiceItem
— جهاز MultipleChoiceItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms