Forms Service

نماذج Google

تسمح هذه الخدمة للنصوص البرمجية بإنشاء "نماذج Google" والوصول إليها وتعديلها.

// Create a new form, then add a checkbox question, a multiple choice question,
// a page break, then a date question and a grid of questions.
var form = FormApp.create('New Form');
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?');
item.setChoices([
        item.createChoice('Ketchup'),
        item.createChoice('Mustard'),
        item.createChoice('Relish')
    ]);
form.addMultipleChoiceItem()
    .setTitle('Do you prefer cats or dogs?')
    .setChoiceValues(['Cats','Dogs'])
    .showOtherOption(true);
form.addPageBreakItem()
    .setTitle('Getting to know you');
form.addDateItem()
    .setTitle('When were you born?');
form.addGridItem()
    .setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);
Logger.log('Published URL: ' + form.getPublishedUrl());
Logger.log('Editor URL: ' + form.getEditUrl());

صفوف

الاسموصف قصير
Alignmentفهرس يمثّل الأنواع المتوافقة من محاذاة الصور
CheckboxGridItemعنصر سؤال، يتم عرضه كشبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيارات متعدّدة لكل صف من تسلسل مربّعات اختيار.
CheckboxGridValidationعنصر التحقّق من البيانات لعنصر CheckboxGridItem.
CheckboxGridValidationBuilderعنصر DataValidationBuilder لعنصر CheckboxGridValidation.
CheckboxItemعنصر سؤال يسمح للمجيب باختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى حقل "غير ذلك" اختياري
CheckboxValidationعنصر التحقّق من البيانات لعنصر CheckboxItem.
CheckboxValidationBuilderعنصر DataValidationBuilder لعنصر CheckboxValidation.
Choiceخيار واحد مرتبط بنوع من Item يتيح خيارات، مثل CheckboxItem أو ListItem أو MultipleChoiceItem
DateItemعنصر سؤال يسمح للمستجيب بتحديد تاريخ.
DateTimeItemعنصر سؤال يسمح للمجيب بتحديد تاريخ ووقت
DestinationTypeفهرس يمثّل الأنواع المتوافقة لوجهَي استجابة النموذج
DurationItemعنصر سؤال يسمح للمستجيب بتحديد مدة زمنية.
FeedbackTypeمصنّف يمثّل الأنواع المتوافقة من الملاحظات.
Formنموذج يحتوي على الخصائص والعناصر العامة
FormAppالسماح لنص برمجي بفتح Form حالي أو إنشاء Form جديد
FormResponseردّ على النموذج ككل
GridItemعنصر سؤال، يتم عرضه كشبكة من الأعمدة والصفوف، يسمح للمجيب باختيار خيار واحد لكل صف من تسلسل أزرار اختيار.
GridValidationعنصر التحقّق من البيانات لعنصر GridItem.
GridValidationBuilderعنصر DataValidationBuilder لعنصر GridValidation.
ImageItemعنصر تنسيق يعرض صورة.
Itemعنصر نموذج عام يحتوي على سمات شائعة لجميع العناصر، مثل العنوان ونص المساعدة.
ItemResponseردّ على عنصر سؤال واحد ضمن نموذج
ItemTypeمصنّف يمثّل الأنواع المتوافقة من عناصر النموذج
ListItemعنصر سؤال يسمح للمجيب باختيار خيار واحد من قائمة منسدلة.
MultipleChoiceItemعنصر سؤال يسمح للمجيب باختيار خيار واحد من قائمة أزرار اختيار أو حقل اختياري "غير ذلك".
PageBreakItemعنصر تنسيق يشير إلى بداية صفحة
PageNavigationTypeمصنّف يمثّل الأنواع المتوافقة من التنقّل في الصفحة
ParagraphTextItemعنصر سؤال يسمح للمجيب بإدخال مقطع نصي
ParagraphTextValidationعنصر التحقّق من البيانات لعنصر ParagraphTextItem.
ParagraphTextValidationBuilderعنصر DataValidationBuilder لعنصر ParagraphTextValidation.
QuizFeedbackتنفيذ عنصر Feedback، الذي يحتوي على سمات شائعة لجميع الملاحظات، مثل عرض النص أو الروابط
QuizFeedbackBuilderفئة FeedbackBuilder الأساسية التي تحتوي على أدوات ضبط للسمات الشائعة لجميع الملاحظات، مثل نص العرض
RatingIconTypeفهرس يمثّل الأنواع المتوافقة من رموز التقييم
RatingItemعنصر سؤال يسمح للمجيب بتقديم تقييم.
ScaleItemعنصر سؤال يسمح للمستجيب باختيار خيار واحد من تسلسل مرقّم لأزرار radio.
SectionHeaderItemعنصر تنسيق يشير بصريًا إلى بداية قسم
TextItemعنصر سؤال يسمح للمستجيب بإدخال سطر واحد من النص.
TextValidationعنصر التحقّق من البيانات لعنصر TextItem.
TextValidationBuilderعنصر DataValidationBuilder لعنصر TextValidation.
TimeItemعنصر سؤال يسمح للمستجيب بتحديد وقت من اليوم
VideoItemعنصر تنسيق يعرض فيديو

Alignment

أماكن إقامة

الموقعالنوعالوصف
LEFTEnumمحاذاة الصورة على يمين النموذج
CENTEREnumمحاذاة الصورة في منتصف النموذج
RIGHTEnumمحاذاة الصورة على الجانب الأيمن من النموذج

CheckboxGridItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
clearValidation()CheckboxGridItemتزيل أي عملية تحقّق من صحة البيانات لعنصر الشبكة هذا.
createResponse(responses)ItemResponseلإنشاء ItemResponse جديد لعنصر شبكة مربّعات الاختيار هذا.
duplicate()CheckboxGridItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getColumns()String[]تحصل على قيم كل عمود في الشبكة.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getRows()String[]تحصل على قيم كل صف في الشبكة.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setColumns(columns)CheckboxGridItemتُستخدَم لضبط أعمدة الشبكة استنادًا إلى صفيف من القيم.
setHelpText(text)CheckboxGridItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setRequired(enabled)CheckboxGridItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setRows(rows)CheckboxGridItemتضبط صفوف الشبكة استنادًا إلى صفيف من القيم.
setTitle(title)CheckboxGridItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setValidation(validation)CheckboxGridItemتُستخدَم لضبط ميزة التحقّق من صحة البيانات لعنصر شبكة مربّعات الاختيار هذا.

CheckboxGridValidation

CheckboxGridValidationBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
requireLimitOneResponsePerColumn()CheckboxGridValidationBuilderيتطلب الحدّ من الإجابة الواحدة لكل عمود لعنصر الشبكة.

CheckboxItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
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لتحديد ما إذا كان العنصر يتضمّن خيار "غير ذلك".
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لتحديد ما إذا كان العنصر يتضمّن خيار "غير ذلك".

CheckboxValidation

CheckboxValidationBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
requireSelectAtLeast(number)CheckboxValidationBuilderاطلب تحديد هذا العدد من الخيارات على الأقل.
requireSelectAtMost(number)CheckboxValidationBuilderتتطلّب اختيار هذا العدد من الخيارات كحدّ أقصى.
requireSelectExactly(number)CheckboxValidationBuilderتتطلّب تحديد هذا العدد من الخيارات بالضبط.

Choice

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getGotoPage()PageBreakItemيتم ضبط PageBreakItem كوجهة GO_TO_PAGE إذا اختار المجيب هذا الخيار وأكمل الصفحة الحالية.
getPageNavigationType()PageNavigationTypeتحصل على PageNavigationType التي تحدث إذا اختار المجيب هذا الخيار و أكمل الصفحة الحالية.
getValue()Stringتحصل على قيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج.
isCorrectAnswer()Booleanتحصل على ما إذا كان الخيار هو إجابة صحيحة للسؤال.

DateItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createResponse(response)ItemResponseتُنشئ هذه السمة ItemResponse جديدة لعنصر التاريخ هذا.
duplicate()DateItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
includesYear()Booleanلتحديد ما إذا كان عنصر التاريخ يتضمّن خيار السنة.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)DateItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)DateItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setIncludesYear(enableYear)DateItemلضبط ما إذا كان عنصر التاريخ يتضمّن إعدادًا للسنة.
setPoints(points)DateItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)DateItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)DateItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

DateTimeItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createResponse(response)ItemResponseلإنشاء ItemResponse جديد لهذا العنصر بالتاريخ والوقت
duplicate()DateTimeItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
includesYear()Booleanلتحديد ما إذا كان عنصر التاريخ يتضمّن خيار السنة.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)DateTimeItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)DateTimeItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemلضبط ما إذا كان عنصر التاريخ يتضمّن إعدادًا للسنة.
setPoints(points)DateTimeItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)DateTimeItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)DateTimeItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

DestinationType

أماكن إقامة

الموقعالنوعالوصف
SPREADSHEETEnumجدول بيانات في "جداول بيانات Google" كوجهة للردود على النماذج

DurationItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createResponse(hours, minutes, seconds)ItemResponseتُنشئ هذه السمة ItemResponse جديدة لعنصر التاريخ هذا.
duplicate()DurationItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)DurationItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)DurationItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)DurationItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)DurationItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)DurationItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

FeedbackType

أماكن إقامة

الموقعالنوعالوصف
CORRECTEnumملاحظات يتم عرضها تلقائيًا للمجيبين عن سؤال تمّت الإجابة عنه بشكل صحيح.
INCORRECTEnumملاحظات يتم عرضها تلقائيًا للمجيبين على سؤال تمّت الإجابة عنه بشكل غير صحيح.
GENERALEnumالملاحظات التي يتم عرضها تلقائيًا للمستجيبين عند إرسال ردّهم

Form

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addCheckboxGridItem()CheckboxGridItemتُلحق هذه السمة عنصر سؤال جديد، يتم عرضه كشبكة من الأعمدة والصفوف، ويسمح لموضوع القياس بتحديد خيارات متعدّدة لكل صف من تسلسل مربّعات اختيار.
addCheckboxItem()CheckboxItemيُلحق هذا الخيار عنصر سؤال جديد يتيح للمستجيب اختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى حقل اختياري "غير ذلك".
addDateItem()DateItemإلحاق عنصر سؤال جديد يتيح للمجيب الإشارة إلى تاريخ
addDateTimeItem()DateTimeItemإلحاق عنصر سؤال جديد يتيح للمجيب الإشارة إلى تاريخ ووقت
addDurationItem()DurationItemيُلحق هذا المقياس عنصر سؤال جديد يتيح للمستجيب الإشارة إلى مدة زمنية.
addEditor(emailAddress)Formتُضيف هذه السمة المستخدم المحدّد إلى قائمة المحرِّرين في Form.
addEditor(user)Formتُضيف هذه السمة المستخدم المحدّد إلى قائمة المحرِّرين في Form.
addEditors(emailAddresses)Formتُضيف الصفيف المحدّد من المستخدمين إلى قائمة المحرِّرين في Form.
addGridItem()GridItemتُلحق عنصر سؤال جديد، يتم عرضه كشبكة من الأعمدة والصفوف، يسمح للمستجيب باختيار خيار واحد لكل صف من تسلسل أزرار اختيار.
addImageItem()ImageItemإلحاق عنصر تنسيق جديد يعرض صورة
addListItem()ListItemيُلحق عنصر سؤال جديد يتيح للمستجيب اختيار خيار واحد من قائمة منسدلة.
addMultipleChoiceItem()MultipleChoiceItemتُضيف هذه السمة عنصر سؤال جديد يتيح للمستجيب اختيار خيار واحد من قائمة أزرار radio buttons أو حقل اختياري "غير ذلك".
addPageBreakItem()PageBreakItemتُضيف عنصر تنسيق جديدًا يحدِّد بداية صفحة.
addParagraphTextItem()ParagraphTextItemتُضيف عنصر سؤال جديد يسمح للمستجيب بإدخال مجموعة من النصوص.
addRatingItem()RatingItemتُلحق عنصر سؤال جديد يتيح للمجيب تقديم تقييم.
addScaleItem()ScaleItemيُلحق عنصر سؤال جديدًا يسمح للمستجيب باختيار خيار واحد من تسلسل مرقّم لأزرار الاختيار.
addSectionHeaderItem()SectionHeaderItemيُلحق عنصر تنسيق جديدًا يشير بصريًا إلى بداية قسم.
addTextItem()TextItemتُلحق عنصر سؤال جديدًا يسمح للمستجيب بإدخال سطر واحد من النص.
addTimeItem()TimeItemتُلحق عنصر سؤال جديد يتيح للمجيب الإشارة إلى وقت من اليوم.
addVideoItem()VideoItemتُلحق عنصر تنسيق جديدًا يعرض فيديو.
canEditResponse()Booleanلتحديد ما إذا كان النموذج سيعرض رابطًا لتعديل ردّ بعد إرساله.
collectsEmail()Booleanلتحديد ما إذا كان النموذج يجمع عناوين البريد الإلكتروني للمستجيبين.
createResponse()FormResponseلإنشاء ردّ جديد على النموذج
deleteAllResponses()Formلحذف جميع الردود المرسَلة من مخزن الردود في النموذج
deleteItem(index)voidلحذف العنصر في فهرس معيّن من بين جميع العناصر في النموذج
deleteItem(item)voidلحذف العنصر المحدّد.
deleteResponse(responseId)Formلحذف ردّ واحد من ذاكرة الردود في النموذج
getConfirmationMessage()Stringتحصل على رسالة تأكيد النموذج.
getCustomClosedFormMessage()Stringتحصل على الرسالة المخصّصة التي يتم عرضها إذا كان النموذج لا يقبل الردود، أو سلسلة فارغة إذا لم يتم ضبط رسالة مخصّصة.
getDescription()Stringللحصول على وصف النموذج
getDestinationId()Stringللحصول على معرّف وجهة الردّ في النموذج
getDestinationType()DestinationTypeتحصل على نوع وجهة الردّ في النموذج.
getEditUrl()Stringتحصل على عنوان URL الذي يمكن استخدامه للوصول إلى وضع تعديل النموذج.
getEditors()User[]تحصل على قائمة بالمحرِّرين لهذا Form.
getId()Stringللحصول على معرّف النموذج
getItemById(id)Itemالحصول على السلعة التي تحمل معرّفًا معيّنًا
getItems()Item[]تحصل على صفيف من جميع العناصر في النموذج.
getItems(itemType)Item[]تحصل على صفيف من جميع العناصر من نوع معيّن.
getPublishedUrl()Stringتحصل على عنوان URL الذي يمكن استخدامه للردّ على النموذج.
getResponse(responseId)FormResponseتحصل على ردّ نموذج واحد استنادًا إلى معرّف الردّ.
getResponses()FormResponse[]تحصل على صفيف من جميع ردود النموذج.
getResponses(timestamp)FormResponse[]تحصل على صفيف من جميع ردود النموذج بعد تاريخ ووقت محدّدَين.
getShuffleQuestions()Booleanلتحديد ما إذا كان ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا
getSummaryUrl()Stringتحصل على عنوان URL الذي يمكن استخدامه لعرض ملخّص للردود على النموذج.
getTitle()Stringتحصل على عنوان النموذج.
hasLimitOneResponsePerUser()Booleanتحدِّد ما إذا كان النموذج يسمح بإرسال رد واحد فقط لكل مستجيب.
hasProgressBar()Booleanيحدِّد ما إذا كان النموذج يعرض شريط تقدّم.
hasRespondAgainLink()Booleanيحدِّد ما إذا كان النموذج سيعرض رابطًا لإرسال ردّ آخر بعد أن يُكمِل أحد المستجيبين النموذج.
isAcceptingResponses()Booleanلتحديد ما إذا كان النموذج يقبل الردود حاليًا.
isPublishingSummary()Booleanتحدِّد ما إذا كان النموذج سيعرض رابطًا لعرض ملخّص للردود بعد أن يُكمِل أحد المجيبين النموذج.
isQuiz()Booleanلتحديد ما إذا كان النموذج اختبارًا
moveItem(from, to)Itemتنقل هذه الدالة عنصرًا في فهرس معيّن بين جميع العناصر في النموذج إلى فهرس آخر معيّن.
moveItem(item, toIndex)Itemتنقل عنصرًا معيّنًا إلى فهرس معيّن بين جميع العناصر في النموذج.
removeDestination()Formيؤدي ذلك إلى إلغاء ربط النموذج بوجهة الردّ الحالية.
removeEditor(emailAddress)Formتزيل هذه الدالة المستخدم المحدّد من قائمة المحرِّرين في Form.
removeEditor(user)Formتزيل هذه الدالة المستخدم المحدّد من قائمة المحرِّرين في Form.
setAcceptingResponses(enabled)Formلضبط ما إذا كان النموذج يقبل الردود حاليًا.
setAllowResponseEdits(enabled)Formلضبط ما إذا كان النموذج سيعرض رابطًا لتعديل ردّ بعد إرساله.
setCollectEmail(collect)Formلضبط ما إذا كان النموذج سيجمع عناوين البريد الإلكتروني للمستجيبين.
setConfirmationMessage(message)Formلضبط رسالة تأكيد النموذج.
setCustomClosedFormMessage(message)Formلضبط الرسالة التي ستظهر إذا كان النموذج لا يقبل الردود.
setDescription(description)Formلضبط وصف النموذج
setDestination(type, id)Formلضبط الوجهة التي يتم حفظ ردود النماذج فيها
setIsQuiz(enabled)Formلتحديد ما إذا كان النموذج اختبارًا
setLimitOneResponsePerUser(enabled)Formلضبط ما إذا كان النموذج يسمح باستجابة واحدة فقط لكل مستجيب.
setProgressBar(enabled)Formلضبط ما إذا كان النموذج يحتوي على شريط تقدّم.
setPublishingSummary(enabled)Formلضبط ما إذا كان النموذج سيعرض رابطًا لعرض ملخّص للردود بعد إرسال أحد المجيبين النموذج.
setShowLinkToRespondAgain(enabled)Formلضبط ما إذا كان النموذج سيعرض رابطًا لإرسال ردّ آخر بعد إكمال المستجيب النموذج.
setShuffleQuestions(shuffle)Formلتحديد ما إذا كان ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا
setTitle(title)Formلضبط عنوان النموذج
shortenFormUrl(url)Stringلتحويل عنوان URL طويل لنموذج إلى عنوان URL قصير
submitGrades(responses)Formتُرسِل الدرجات لـ FormResponses المحدّدة.

FormApp

أماكن إقامة

الموقعالنوعالوصف
AlignmentAlignmentقائمة بأنواع محاذاة الصور
DestinationTypeDestinationTypeقائمة بأنواع الوجهات التي يمكنها تخزين الردود على النماذج
FeedbackTypeFeedbackTypeقائمة بأنواع النموذج Feedbacks
ItemTypeItemTypeقائمة بأنواع النموذج Items
PageNavigationTypePageNavigationTypeقائمة بالسلوكيات المحتمَلة للتنقّل في الصفحات
RatingIconTypeRatingIconTypeقائمة بأنواع رموز التقييم RatingIcons

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
create(title)Formلإنشاء Form جديدة وإرجاعها
createCheckboxGridValidation()CheckboxGridValidationBuilderتعرِض هذه السمة مثيلًا لـ CheckboxGridValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق في CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderتعرِض مثيلًا من CheckboxValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق من صحة ملف CheckboxItem.
createFeedback()QuizFeedbackBuilderتعرِض هذه الدالة مثيلًا لـ QuizFeedbackBuilder يمكن استخدامه لضبط الملاحظات على Item قابل للتصنيف.
createGridValidation()GridValidationBuilderتعرِض هذه السمة مثيلًا لـ GridValidationBuilder يمكن استخدامه لضبط عملية التحقّق في GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderتعرِض هذه السمة مثيلًا لـ ParagraphTextValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق من a ParagraphTextItem.
createTextValidation()TextValidationBuilderتعرِض هذه الدالة مثيلًا لـ TextValidationBuilder يمكن استخدامه لضبط عملية التحقّق من الصحة في TextItem.
getActiveForm()Formلعرض النموذج الذي يكون النص البرمجي مرتبطًا به.
getUi()Uiتعرِض مثيلًا لبيئة واجهة مستخدِم محرِّر النماذج التي تسمح للبرنامج النصي بإضافة ميزات مثل القوائم ومربّعات الحوار والأشرطة الجانبية.
openById(id)Formلعرض Form بالمعرّف المحدّد.
openByUrl(url)Formلعرض Form مع عنوان URL المحدّد.

FormResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getEditResponseUrl()Stringتُنشئ هذه السمة عنوان URL يمكن استخدامه لتعديل ردّ سبق أن تم إرساله.
getGradableItemResponses()ItemResponse[]تحصل على جميع ردود العناصر الواردة في ردّ نموذج، بالترتيب نفسه الذي تظهر به العناصر في النموذج.
getGradableResponseForItem(item)ItemResponseتحصل على استجابة السلعة المضمّنة في استجابة نموذج لسلة معيّنة.
getId()Stringللحصول على رقم تعريف ردّ النموذج
getItemResponses()ItemResponse[]تحصل على جميع ردود العناصر الواردة في ردّ نموذج، بالترتيب نفسه الذي تظهر به العناصر في النموذج.
getRespondentEmail()Stringتحصل على عنوان البريد الإلكتروني للشخص الذي أرسل ردًا، إذا كان الخيار Form.setCollectEmail(collect) مفعّلاً.
getResponseForItem(item)ItemResponseتحصل على استجابة السلعة المضمّنة في استجابة النموذج هذه لسلة معيّنة.
getTimestamp()Dateتحصل على الطابع الزمني لإرسال استجابة نموذج.
submit()FormResponseإرسال الردّ
toPrefilledUrl()Stringتُنشئ هذه السمة عنوان URL للنموذج الذي يتم فيه ملء الإجابات مسبقًا استنادًا إلى الإجابات الواردة في استجابة النموذج هذه.
withItemGrade(gradedResponse)FormResponseتُضيف الدرجات الخاصة بردّ العنصر المحدّد إلى ردّ على النموذج.
withItemResponse(response)FormResponseتُضيف استجابة السلعة المحدّدة إلى استجابة نموذج.

GridItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
clearValidation()GridItemتزيل أي عملية تحقّق من صحة البيانات لعنصر الشبكة هذا.
createResponse(responses)ItemResponseلإنشاء ItemResponse جديدة لعنصر الشبكة هذا
duplicate()GridItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getColumns()String[]تحصل على قيم كل عمود في الشبكة.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getRows()String[]تحصل على قيم كل صف في الشبكة.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setColumns(columns)GridItemتُستخدَم لضبط أعمدة الشبكة استنادًا إلى صفيف من القيم.
setHelpText(text)GridItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setRequired(enabled)GridItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setRows(rows)GridItemتضبط صفوف الشبكة استنادًا إلى صفيف من القيم.
setTitle(title)GridItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setValidation(validation)GridItemتُستخدَم لضبط ميزة التحقّق من صحة البيانات لعنصر الشبكة هذا.

GridValidation

GridValidationBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
requireLimitOneResponsePerColumn()GridValidationBuilderيتطلب الحدّ من الإجابة الواحدة لكل عمود لعنصر الشبكة.

ImageItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
duplicate()ImageItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getAlignment()Alignmentالحصول على المحاذاة الأفقية للصورة
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getImage()Blobتحصل على الصورة المحدّدة حاليًا للعنصر.
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
getWidth()Integerتحصل على عرض الصورة بالبكسل.
setAlignment(alignment)ImageItemلضبط المحاذاة الأفقية للصورة
setHelpText(text)ImageItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setImage(image)ImageItemلضبط الصورة نفسها
setTitle(title)ImageItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setWidth(width)ImageItemلضبط عرض الصورة بالبكسل.

Item

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
asCheckboxGridItem()CheckboxGridItemلعرض العنصر كعنصر شبكة مربّعات اختيار.
asCheckboxItem()CheckboxItemلعرض العنصر كعنصر مربّع اختيار.
asDateItem()DateItemلعرض العنصر كعنصر تاريخ.
asDateTimeItem()DateTimeItemلعرض العنصر كعنصر تاريخ ووقت.
asDurationItem()DurationItemلعرض العنصر كعنصر مدة.
asGridItem()GridItemلعرض العنصر كعنصر شبكة.
asImageItem()ImageItemلعرض العنصر كعنصر صورة.
asListItem()ListItemلعرض العنصر كعنصر قائمة.
asMultipleChoiceItem()MultipleChoiceItemلعرض العنصر كعنصر اختيار من متعدد.
asPageBreakItem()PageBreakItemلعرض العنصر كعنصر فاصل صفحة.
asParagraphTextItem()ParagraphTextItemلعرض العنصر كعنصر نص فقرة.
asRatingItem()RatingItemلعرض العنصر كتقييم.
asScaleItem()ScaleItemلعرض العنصر كعنصر مقياس.
asSectionHeaderItem()SectionHeaderItemلعرض العنصر كعنصر لعنوان القسم.
asTextItem()TextItemلعرض العنصر كعنصر نصي.
asTimeItem()TimeItemلعرض العنصر كعنصر وقت.
asVideoItem()VideoItemلعرض العنصر كعنصر فيديو.
duplicate()Itemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
setHelpText(text)Itemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setTitle(title)Itemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

ItemResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getFeedback()Objectللحصول على الملاحظات التي تم تقديمها للإجابة التي أرسلها المجيب.
getItem()Itemتحصل على عنصر السؤال الذي تجيب عنه هذه الإجابة.
getResponse()Objectتحصل على الإجابة التي أرسلها المجيب.
getScore()Objectتحصل على النتيجة للإجابة التي أرسلها المجيب.
setFeedback(feedback)ItemResponseتُستخدَم لضبط الملاحظات التي يجب عرضها للإجابة التي أرسلها المستجوب.
setScore(score)ItemResponseتُستخدَم لتحديد النتيجة للإجابة التي أرسلها المجيب.

ItemType

أماكن إقامة

الموقعالنوعالوصف
CHECKBOXEnumعنصر سؤال يسمح للمجيب باختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى حقل "غير ذلك" اختياري
CHECKBOX_GRIDEnumعنصر سؤال، يتم عرضه كشبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيارات متعدّدة لكل صف من تسلسل مربّعات اختيار.
DATEEnumعنصر سؤال يسمح للمستجيب بتحديد تاريخ.
DATETIMEEnumعنصر سؤال يسمح للمجيب بتحديد تاريخ ووقت
DURATIONEnumعنصر سؤال يسمح للمستجيب بتحديد مدة زمنية.
GRIDEnumعنصر سؤال، يتم عرضه كشبكة من الأعمدة والصفوف، يسمح للمجيب باختيار خيار واحد لكل صف من تسلسل أزرار اختيار.
IMAGEEnumعنصر تنسيق يعرض صورة.
LISTEnumعنصر سؤال يسمح للمجيب باختيار خيار واحد من قائمة منسدلة.
MULTIPLE_CHOICEEnumعنصر سؤال يسمح للمجيب باختيار خيار واحد من قائمة أزرار اختيار أو حقل اختياري "غير ذلك".
PAGE_BREAKEnumعنصر تنسيق يشير إلى بداية صفحة
PARAGRAPH_TEXTEnumعنصر سؤال يسمح للمجيب بإدخال مقطع نصي
RATINGEnumعنصر سؤال يسمح للمجيب بتقديم تقييم.
SCALEEnumعنصر سؤال يسمح للمجيب باختيار خيار واحد من تسلسل مرقم من أزرار الاختيار.
SECTION_HEADEREnumعنصر تنسيق يشير بصريًا إلى بداية قسم
TEXTEnumعنصر سؤال يسمح للمستجيب بإدخال سطر واحد من النص.
TIMEEnumعنصر سؤال يسمح للمستجيب بتحديد وقت من اليوم
VIDEOEnumعنصر تنسيق يعرض فيديو على YouTube
FILE_UPLOADEnumعنصر سؤال يتيح للمجيب تحميل ملف.
UNSUPPORTEDEnumعنصر غير متاح حاليًا من خلال واجهات برمجة التطبيقات

ListItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createChoice(value)Choiceلإنشاء خيار جديد.
createChoice(value, isCorrect)Choiceلإنشاء خيار جديد.
createChoice(value, navigationItem)Choiceينشئ خيارًا جديدًا يتضمّن خيارًا للتنقّل في الصفحة يقفز إلى عنصر فاصل صفحة معيّن.
createChoice(value, navigationType)Choiceتُنشئ خيارًا جديدًا يتضمّن خيارًا للتنقّل في الصفحة.
createResponse(response)ItemResponseلإنشاء ItemResponse جديدة لعنصر القائمة هذا.
duplicate()ListItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getChoices()Choice[]الحصول على جميع الخيارات لعنصر معيّن
getFeedbackForCorrect()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون بشكل صحيح عن سؤال.
getFeedbackForIncorrect()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون بشكل غير صحيح عن سؤال.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setChoiceValues(values)ListItemتُستخدَم لضبط خيارات عنصر من مصفوفة سلاسل.
setChoices(choices)ListItemتُستخدَم لضبط مصفوفة من الخيارات لعنصر معيّن.
setFeedbackForCorrect(feedback)ListItemلضبط الملاحظات التي ستظهر للمستجيبين عند إجابتهم بشكل صحيح عن سؤال.
setFeedbackForIncorrect(feedback)ListItemلضبط الملاحظات التي ستظهر للمجيبين عندما يجيبون بشكل غير صحيح عن سؤال.
setHelpText(text)ListItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)ListItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)ListItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)ListItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

MultipleChoiceItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
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لتحديد ما إذا كان العنصر يتضمّن خيار "غير ذلك".

PageBreakItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
duplicate()PageBreakItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGoToPage()PageBreakItemتحصل على PageBreakItem الذي سينتقل إليه النموذج بعد إكمال الصفحة قبل فاصل الصفحة هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدّم الخطي العادي في الجدول).
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPageNavigationType()PageNavigationTypeتحصل على نوع التنقّل في الصفحة الذي يحدث بعد إكمال الصفحة قبل فاصل الصفحة هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدّم الخطي العادي في النموذج).
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
setGoToPage(goToPageItem)PageBreakItemلضبط الصفحة التي سيتم الانتقال إليها بعد إكمال الصفحة قبل فاصل الصفحة هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدّم الخطي العادي في النموذج).
setGoToPage(navigationType)PageBreakItemلضبط نوع التنقّل في الصفحة الذي يحدث بعد إكمال الصفحة قبل فاصل الصفحة هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدّم الخطي العادي في النموذج).
setHelpText(text)PageBreakItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setTitle(title)PageBreakItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

أماكن إقامة

الموقعالنوعالوصف
CONTINUEEnumانتقِل إلى الصفحة التالية من النموذج بعد إكمال الصفحة الحالية.
GO_TO_PAGEEnumالانتقال إلى صفحة محدّدة من النموذج بعد إكمال الصفحة الحالية
RESTARTEnumيُرجى إعادة ملء النموذج من البداية بدون محو الإجابات التي أدخلتها حتى الآن، وذلك بعد إكمال الصفحة الحالية.
SUBMITEnumأرسِل ردّ النموذج بعد إكمال الصفحة الحالية.

ParagraphTextItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
clearValidation()ParagraphTextItemتزيل هذه السمة أي عملية تحقّق من صحة البيانات لعنصر نص الفقرة هذا.
createResponse(response)ItemResponseلإنشاء ItemResponse جديد لعنصر نص الفقرة هذا.
duplicate()ParagraphTextItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)ParagraphTextItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)ParagraphTextItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)ParagraphTextItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)ParagraphTextItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)ParagraphTextItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setValidation(validation)ParagraphTextItemتُستخدَم لضبط ميزة التحقّق من صحة البيانات لعنصر نص الفقرة هذا.

ParagraphTextValidation

ParagraphTextValidationBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
requireTextContainsPattern(pattern)ParagraphTextValidationBuilderيجب أن يحتوي الردّ على نمط.
requireTextDoesNotContainPattern(pattern)ParagraphTextValidationBuilderيجب ألا يحتوي الردّ على نمط.
requireTextDoesNotMatchPattern(pattern)ParagraphTextValidationBuilderيجب أن لا تتطابق الإجابة مع النمط.
requireTextLengthGreaterThanOrEqualTo(number)ParagraphTextValidationBuilderتتطلّب هذه السمة أن يكون طول الاستجابة أكبر من القيمة أو يساويها.
requireTextLengthLessThanOrEqualTo(number)ParagraphTextValidationBuilderتتطلّب هذه السمة أن يكون طول الاستجابة أقل من القيمة.
requireTextMatchesPattern(pattern)ParagraphTextValidationBuilderيجب أن تتطابق الإجابة مع النمط.

QuizFeedback

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getLinkUrls()String[]الحصول على قائمة بعناوين URL المرتبطة بالملاحظات
getText()Stringللحصول على النص المعروض للملاحظات

QuizFeedbackBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addLink(url)QuizFeedbackBuilderإضافة رابط إلى المادة التكميلية للملاحظات
addLink(url, displayText)QuizFeedbackBuilderإضافة رابط إلى المادة التكميلية للملاحظات
build()QuizFeedbackتُنشئ "ملاحظات" من النوع المقابل لهذا المُنشئ.
copy()QuizFeedbackBuilderتعرِض نسخة من هذا المُنشئ.
setText(text)QuizFeedbackBuilderلضبط نص الملاحظات.

RatingIconType

أماكن إقامة

الموقعالنوعالوصف
STAREnumرمز نجمة
HEARTEnumرمز قلب
THUMB_UPEnumرمز إبداء الإعجاب

RatingItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createResponse(response)ItemResponseلإنشاء ItemResponse جديدة لعنصر التقييم هذا
duplicate()RatingItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getRatingIcon()RatingIconTypeالحصول على الرمز الذي تم اختياره للتقييم
getRatingScaleLevel()Integerتحصل على مستوى مقياس التقييم.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)RatingItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)RatingItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)RatingItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRatingIcon(ratingIcon)RatingItemلضبط رمز التقييم
setRatingScaleLevel(ratingScaleLevel)RatingItemلضبط الحد الأقصى لمقياس التقييم.
setRequired(enabled)RatingItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)RatingItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

ScaleItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createResponse(response)ItemResponseلإنشاء ItemResponse جديدة لعنصر المقياس هذا
duplicate()ScaleItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getLeftLabel()Stringتحصل على تصنيف الحدّ الأدنى للمقياس، إن توفّر.
getLowerBound()Integerتحصل على الحد الأدنى للمقياس.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getRightLabel()Stringتحصل على تصنيف الحدّ الأقصى للمقياس، إن توفّر.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
getUpperBound()Integerتحصل على الحدّ الأقصى للمقياس.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setBounds(lower, upper)ScaleItemلضبط الحدود الدنيا والعليا للمقياس
setGeneralFeedback(feedback)ScaleItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)ScaleItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setLabels(lower, upper)ScaleItemتُستخدَم لضبط تصنيفات للحدود الدنيا والعليا للمقياس.
setPoints(points)ScaleItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)ScaleItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)ScaleItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

SectionHeaderItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
duplicate()SectionHeaderItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
setHelpText(text)SectionHeaderItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setTitle(title)SectionHeaderItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

TextItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
clearValidation()TextItemتزيل هذه القيمة أي عملية تحقّق من صحة البيانات لهذا العنصر النصي.
createResponse(response)ItemResponseلإنشاء ItemResponse جديد لهذا العنصر النصي
duplicate()TextItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)TextItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)TextItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)TextItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)TextItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)TextItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setValidation(validation)TextItemتُستخدَم لضبط ميزة التحقّق من صحة البيانات لهذا العنصر النصي.

TextValidation

TextValidationBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
requireNumber()TextValidationBuilderيتطلب عنصر النص أن يكون رقمًا.
requireNumberBetween(start, end)TextValidationBuilderتتطلّب هذه السمة أن يكون العنصر النصي رقمًا بين البدء والنهاية، بما في ذلك.
requireNumberEqualTo(number)TextValidationBuilderتتطلّب هذه الدالة أن يكون العنصر النصي رقمًا يساوي القيمة المحدّدة.
requireNumberGreaterThan(number)TextValidationBuilderتتطلّب هذه الدالة أن يكون العنصر النصي رقمًا أكبر من القيمة المحدّدة.
requireNumberGreaterThanOrEqualTo(number)TextValidationBuilderتتطلّب هذه السمة أن يكون العنصر النصي رقمًا أكبر من أو يساوي القيمة المحدّدة.
requireNumberLessThan(number)TextValidationBuilderتتطلّب هذه السمة أن يكون العنصر النصي رقمًا أقل من القيمة المحدّدة.
requireNumberLessThanOrEqualTo(number)TextValidationBuilderتتطلّب هذه السمة أن يكون العنصر النصي رقمًا أقل من أو يساوي القيمة المحدّدة.
requireNumberNotBetween(start, end)TextValidationBuilderتتطلّب هذه السمة أن يكون العنصر النصي رقمًا لا يقع بين البدء والنهاية.
requireNumberNotEqualTo(number)TextValidationBuilderيتطلّب هذا الشرط أن يكون العنصر النصي رقمًا لا يساوي القيمة المحدّدة.
requireTextContainsPattern(pattern)TextValidationBuilderيجب أن يحتوي الردّ على نمط.
requireTextDoesNotContainPattern(pattern)TextValidationBuilderيجب ألا يحتوي الردّ على نمط.
requireTextDoesNotMatchPattern(pattern)TextValidationBuilderيجب أن لا تتطابق الإجابة مع النمط.
requireTextIsEmail()TextValidationBuilderيتطلب أن يكون العنصر النصي عنوان بريد إلكتروني.
requireTextIsUrl()TextValidationBuilderتتطلّب أن يكون العنصر النصي عنوان URL.
requireTextLengthGreaterThanOrEqualTo(number)TextValidationBuilderتتطلّب هذه السمة أن يكون طول الاستجابة أكبر من القيمة أو يساويها.
requireTextLengthLessThanOrEqualTo(number)TextValidationBuilderتتطلّب هذه السمة أن يكون طول الاستجابة أقل من القيمة.
requireTextMatchesPattern(pattern)TextValidationBuilderيجب أن تتطابق الإجابة مع النمط.
requireWholeNumber()TextValidationBuilderيتطلب هذا الحقل أن يكون العنصر النصي عددًا صحيحًا.

TimeItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createResponse(hour, minute)ItemResponseلإنشاء ItemResponse جديد لهذا العنصر الزمني
duplicate()TimeItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getGeneralFeedback()QuizFeedbackتعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getPoints()Integerلعرض قيمة النقاط لعنصر قابل للتصنيف.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)TimeItemلضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)TimeItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)TimeItemلضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)TimeItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)TimeItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

VideoItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
duplicate()VideoItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getAlignment()Alignmentالحصول على المحاذاة الأفقية للفيديو
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
getWidth()Integerتحصل على عرض الفيديو بالبكسل.
setAlignment(alignment)VideoItemلضبط المحاذاة الأفقية للفيديو
setHelpText(text)VideoItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setTitle(title)VideoItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setVideoUrl(youtubeUrl)VideoItemلضبط الفيديو نفسه من عنوان URL أو معرّف فيديو معيّنَين على YouTube
setWidth(width)VideoItemلضبط عرض الفيديو بالبكسل