Forms Service

النماذج

تسمح هذه الخدمة للنصوص البرمجية بإنشاء "نماذج 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 حالية أو إنشاء رمز جديد.
FormResponseتمثّل هذه السمة ردًا على النموذج ككل.
GridItemعنصر سؤال، يتم تقديمه على شكل شبكة من الأعمدة والصفوف، يسمح للمجيب بتحديد خيار واحد لكل صف من سلسلة من أزرار الاختيار.
GridValidationالتحقق من صحة البيانات لـ GridItem
GridValidationBuilderأداة DataValidationBuilder لـ GridValidation.
ImageItemعنصر تصميم يعرض صورة
Itemيشير ذلك المصطلح إلى عنصر عام يحتوي على سمات مشترَكة بين جميع العناصر، مثل العنوان ونص المساعدة.
ItemResponseتمثّل هذه السمة ردًا على عنصر واحد في السؤال داخل نموذج.
ItemTypeتعداد يمثل الأنواع المتوافقة من عناصر النموذج.
ListItemعنصر سؤال يسمح للمجيب بتحديد خيار واحد من القائمة المنسدلة.
MultipleChoiceItemعنصر سؤال يسمح للمجيب بتحديد اختيار واحد من قائمة أزرار الاختيار أو قيمة اختيارية "other" .
PageBreakItemعنصر تخطيط يحدد بداية الصفحة.
PageNavigationTypeتعداد يمثل الأنواع المتوافقة للتنقل في الصفحة.
ParagraphTextItemعنصر سؤال يسمح للمجيب بإدخال جزء من النص.
ParagraphTextValidationالتحقق من صحة البيانات لـ ParagraphTextItem
ParagraphTextValidationBuilderأداة DataValidationBuilder لـ ParagraphTextValidation.
QuizFeedbackتنفيذ فاصوليا لـ Feedback، والتي تحتوي على خصائص مشتركة لجميع الملاحظات، مثل عرض النص أو الروابط.
QuizFeedbackBuilderأداة FeedbackBuilder الأساسية التي تحتوي على أدوات تحديد للخصائص المشتركة لجميع الملاحظات، مثل النص المعروض.
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تعرض الملاحظات التي تظهر للمستجيبين عند إجابتهم بشكل صحيح على سؤال.
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 Sheets كوجهة للردود على النموذج.

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تضيف عنصر سؤال جديدًا يسمح للمجيب باختيار واحد من قائمة الراديو أو زر اختياري "other" .
addPageBreakItem()PageBreakItemتضيف عنصر تنسيق جديدًا يميّز بداية الصفحة.
addParagraphTextItem()ParagraphTextItemتضيف عنصر سؤال جديدًا يسمح للمجيب بإدخال جزء من النص.
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
requiresLogin()Booleanيحدد ما إذا كان النموذج يتطلب من المستجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو نطاق فرعي قبل الرد.
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تحدِّد هذه السياسة ما إذا كان النموذج يعرض رابطًا لعرض ملخّص الردود بعد إرسال أحد المستجيبين. النموذج.
setRequireLogin(requireLogin)Formلتحديد ما إذا كان النموذج يتطلب من المستجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو النطاق الفرعي قبل الرد.
setShowLinkToRespondAgain(enabled)Formلضبط ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد إكمال المجيب النموذج.
setShuffleQuestions(shuffle)Formلتحديد ما إذا كان سيتم ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا.
setTitle(title)Formلضبط عنوان النموذج.
shortenFormUrl(url)Stringتحوِّل عنوان URL الطويل الخاص بنموذج إلى عنوان URL مختصر.
submitGrades(responses)Formيؤدي هذا الخيار إلى إرسال الدرجات لنماذج الردود المقدَّمة في النموذج.

FormApp

أماكن إقامة

الموقعالنوعالوصف
AlignmentAlignmentتعداد أنواع محاذاة الصور.
DestinationTypeDestinationTypeيشير ذلك المصطلح إلى تعداد لأنواع الوجهات التي يمكنها تخزين الردود على النموذج.
FeedbackTypeFeedbackTypeتعداد أنواع النماذج Feedbacks.
ItemTypeItemTypeتعداد أنواع النماذج Items.
PageNavigationTypePageNavigationTypeتمثّل هذه السمة تعدادًا للسلوكيات المحتمَلة للتنقل بين الصفحات.

الطُرق

الطريقةنوع الإرجاعوصف قصير
create(title)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الحصول على رقم تعريف الرد على النموذج
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لعرض العنصر كعنصر نصي فقرة.
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عنصر سؤال يسمح للمجيب بتحديد اختيار واحد من قائمة أزرار الاختيار أو قيمة اختيارية "other" .
PAGE_BREAKEnumعنصر تخطيط يحدد بداية الصفحة.
PARAGRAPH_TEXTEnumعنصر سؤال يسمح للمجيب بإدخال جزء من النص.
SCALEEnumعنصر سؤال يسمح للمجيب باختيار خيار واحد من تسلسل رقمي أزرار الاختيار.
SECTION_HEADEREnumيشير ذلك المصطلح إلى عنصر تصميم يشير إلى بداية القسم بشكل مرئي.
TEXTEnumعنصر سؤال يسمح للمجيب بإدخال سطر واحد من النص.
TIMEEnumعنصر سؤال يسمح للمجيب بالإشارة إلى وقت من اليوم.
VIDEOEnumعنصر تنسيق يعرض فيديو على YouTube
FILE_UPLOADEnumعنصر سؤال يسمح للمجيب بتحميل ملف.

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لضبط نص الملاحظات.

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 أو معرّف فيديو معيّن على YouTube
setWidth(width)VideoItemلضبط عرض الفيديو بالبكسل.