عنصر سؤال يسمح للمجيب بتحديد مربع اختيار واحد أو أكثر، بالإضافة إلى
حقل اختياري "أخرى". يمكن الوصول إلى العناصر أو إنشاؤها من "Form
". عند استخدام هذه العناصر في
اختبار، يتم وضع الدرجات تلقائيًا.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
clearValidation() | CheckboxItem | يؤدي إلى إزالة أي عملية التحقق من صحة البيانات لعنصر مربّع الاختيار هذا. |
createChoice(value) | Choice | ينشئ خيارًا جديدًا. |
createChoice(value, isCorrect) | Choice | ينشئ خيارًا جديدًا. |
createResponse(responses) | ItemResponse | إنشاء ItemResponse جديد لعنصر مربّع الاختيار هذا. |
duplicate() | CheckboxItem | لإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج |
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) | CheckboxItem | لضبط الخيارات لعنصر من مصفوفة من السلاسل. |
setChoices(choices) | CheckboxItem | لضبط مصفوفة من الخيارات لعنصر واحد. |
setFeedbackForCorrect(feedback) | CheckboxItem | ضبط الملاحظات بحيث يتم عرضها للمجيبين عندما يجيبون بشكل صحيح على سؤال. |
setFeedbackForIncorrect(feedback) | CheckboxItem | ضبط الملاحظات بحيث يتم عرضها للمجيبين عندما يجيبون بشكل غير صحيح على سؤال. |
setHelpText(text) | CheckboxItem | تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
setPoints(points) | CheckboxItem | لضبط عدد النقاط التي يستحقها العنصر القابل لوضع درجات. |
setRequired(enabled) | CheckboxItem | تحدِّد هذه السياسة ما إذا كان على المجيب الإجابة عن السؤال. |
setTitle(title) | CheckboxItem | لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | لتعيين التحقق من صحة البيانات لعنصر مربع الاختيار هذا. |
showOtherOption(enabled) | CheckboxItem | لتحديد ما إذا كان العنصر يحتوي على خيار "غير ذلك". |
الوثائق التفصيلية
clearValidation()
يؤدي إلى إزالة أي عملية التحقق من صحة البيانات لعنصر مربّع الاختيار هذا.
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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
createResponse(responses)
إنشاء ItemResponse
جديد لعنصر مربّع الاختيار هذا. الوسيطة responses
هي مصفوفة String[]
تحتوي على قيم يجب التحقّق منها. توفر استثناءات إذا كانت هناك أي قيمة لا تتطابق مع اختيار صالح لهذا العنصر، ما لم يتم ضبط showOtherOption(enabled)
على true
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
responses | String[] | مصفوفة من الإجابات الصالحة لعنصر الاختيار من متعدد |
استرجاع الكرة
ItemResponse
— الرد على العنصر
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
لإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
استرجاع الكرة
CheckboxItem
: نسخة طبق الأصل من CheckboxItem
، للتسلسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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[] | مصفوفة قيم الاختيار، والتي يراها المستجيبون كتصنيفات عند عرض النموذج |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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[] | مجموعة من الخيارات |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
الرميات
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 | الملاحظات الجديدة. سيؤدي استخدام قيمة فارغة إلى محو الملاحظات. |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
ضبط الملاحظات بحيث يتم عرضها للمجيبين عندما يجيبون بشكل غير صحيح على سؤال.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
feedback | QuizFeedback | الملاحظات الجديدة |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
لضبط عدد النقاط التي يستحقها العنصر القابل لوضع درجات. القيمة التلقائية للعناصر الجديدة هي 0.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
points | Integer | عدد النقاط التي يستحقها عنصر السؤال |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تحدِّد هذه السياسة ما إذا كان على المجيب الإجابة عن السؤال.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان يجب على المجيب الإجابة على السؤال |
استرجاع الكرة
CheckboxItem
- العنصر الحالي (للسلاسل)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
لتعيين التحقق من صحة البيانات لعنصر مربع الاختيار هذا. سيؤدي تمرير قيمة خالية أو التحقق من الصحة بدون أي دوال تتطلب استدعاء إلى إزالة أي تحقق سابق.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
validation | CheckboxValidation | مربّع الاختيار لتطبيقه على هذا العنصر |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
لتحديد ما إذا كان العنصر يحتوي على خيار "غير ذلك". ويكون الإعداد التلقائي لـ CheckboxItem
أو MultipleChoiceItem
الجديد هو false
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | true إذا كان العنصر يتضمن الخيار "غير ذلك"، وfalse إذا لم يكن الخيار "غير ذلك" |
استرجاع الكرة
CheckboxItem
— جهاز CheckboxItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms