Forms Service

نماذج Google

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

// Create a new unpublished form, then add a checkbox question, a multiple choice question,
// a page break, then a date question and a grid of questions, then publish the form and share
// with responders.
var form = FormApp.create('New Form', /* isPublished= */ false);
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']);

form.setPublished(true);
form.addPublishedReaders(['user@example.com', 'group@example.com']);

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عنصر سؤال يتيح للمستجيب اختيار خيار واحد من تسلسل مرقّم لأزرار اختيار.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح.
getFeedbackForIncorrect()QuizFeedback|nullتعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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يضيف عنصر سؤال جديدًا يتيح للمستجيب اختيار خيار واحد من قائمة أزرار اختيار أو حقل "غير ذلك" اختياري.
addPageBreakItem()PageBreakItemتضيف هذه السمة عنصر تخطيط جديدًا يحدّد بداية الصفحة.
addParagraphTextItem()ParagraphTextItemتضيف هذه السمة عنصر سؤال جديدًا يتيح للمستجيب إدخال فقرة نصية.
addPublishedReader(emailAddress)Formتضيف هذه الطريقة المستخدم المحدّد إلى قائمة المستجيبين لـ Form.
addPublishedReader(user)Formتضيف هذه الطريقة المستخدم المحدّد إلى قائمة المستجيبين لـ Form.
addPublishedReaders(emailAddresses)Formتضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المستجيبين لـ Form.
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[]تعرض هذه الدالة صفيفًا يتضمّن جميع العناصر من نوع معيّن.
getPublishedReaders()User[]تعرض هذه الطريقة قائمة بالمجيبين عن Form.
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تحدّد ما إذا كان النموذج يقبل الردود حاليًا.
isPublished()Booleanتحدِّد هذه السمة ما إذا كان النموذج منشورًا.
isPublishingSummary()Booleanتحدّد ما إذا كان النموذج يعرض رابطًا للاطّلاع على ملخّص الردود بعد أن يكمل المجيب النموذج.
isQuiz()Booleanتحدّد هذه السمة ما إذا كان النموذج اختبارًا.
moveItem(from, to)Itemتنقل هذه الدالة عنصرًا في فهرس معيّن بين جميع العناصر في النموذج إلى فهرس آخر معيّن.
moveItem(item, toIndex)Itemتنقل هذه السمة عنصرًا معيّنًا إلى فهرس معيّن بين جميع العناصر في النموذج.
removeDestination()Formلإلغاء ربط النموذج بوجهة الرد الحالية
removeEditor(emailAddress)Formتزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Form.
removeEditor(user)Formتزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Form.
removePublishedReader(emailAddress)Formيزيل هذا الإجراء المستخدم المحدّد من قائمة المستجيبين لـ Form.
removePublishedReader(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تضبط هذه السمة ما إذا كان النموذج يتضمّن شريط تقدّم.
setPublished(enabled)Formتضبط هذه السمة ما إذا كان النموذج منشورًا.
setPublishingSummary(enabled)Formتحدّد ما إذا كان النموذج يعرض رابطًا للاطّلاع على ملخّص الردود بعد أن يرسل المجيب النموذج.
setShowLinkToRespondAgain(enabled)Formتحدّد ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد أن يكمل المستجيب النموذج.
setShuffleQuestions(shuffle)Formتضبط هذه السمة ما إذا كان ترتيب الأسئلة على كل صفحة من النموذج عشوائيًا.
setTitle(title)Formتضبط هذه السمة عنوان النموذج.
shortenFormUrl(url)Stringتحويل عنوان URL طويل خاص بنموذج إلى عنوان URL قصير
submitGrades(responses)Formيرسل الدرجات لردود النماذج المحدّدة.
supportsAdvancedResponderPermissions()Booleanتحدِّد ما إذا كان النموذج يتيح النشر.

FormApp

الخصائص

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
create(title)Formتنشئ هذه الطريقة Form جديدًا وتعرضه.
create(title, isPublished)Formتنشئ هذه الطريقة Form جديدة وتعرضها بحالة النشر المطلوبة.
createCheckboxGridValidation()CheckboxGridValidationBuilderتعرض هذه الدالة مثيلاً من CheckboxGridValidationBuilder يمكن استخدامه لضبط عملية التحقّق في CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderتعرض هذه الدالة مثيلاً من CheckboxValidationBuilder يمكن استخدامه لضبط عملية التحقّق في CheckboxItem.
createFeedback()QuizFeedbackBuilderتعرض هذه الدالة مثيلاً من QuizFeedbackBuilder يمكن استخدامه لضبط الملاحظات على Item قابلة للتصنيف.
createGridValidation()GridValidationBuilderتعرض هذه الدالة مثيلاً من GridValidationBuilder يمكن استخدامه لضبط عملية التحقّق من الصحة على GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderتعرض هذه الطريقة مثيلاً من ParagraphTextValidationBuilder يمكن استخدامه لضبط عملية التحقّق من الصحة على 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|nullتعرض هذه الدالة رقم تعريف الردّ على النموذج.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح.
getFeedbackForIncorrect()QuizFeedback|nullتعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عندما يجيبون عن سؤال بشكل صحيح.
getFeedbackForIncorrect()QuizFeedback|nullتعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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تضبط هذه السمة عرض الفيديو بالبكسل.