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مُنشئ بيانات صالح لـ CheckboxGridValidation.
CheckboxItemعنصر سؤال يسمح للمجيب باختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى حقل "غير ذلك" اختياري.
CheckboxValidationتم التحقُّق من صحة بيانات CheckboxItem.
CheckboxValidationBuilderمُنشئ بيانات صالح لـ CheckboxValidation.
Choiceتمثّل هذه السمة خيارًا واحدًا مرتبطًا بنوع Item ويتوافق مع الخيارات، مثل CheckboxItem أو ListItem أو MultipleChoiceItem.
DateItemعنصر سؤال يسمح للمجيب بأن يشير إلى تاريخ.
DateTimeItemيشير هذا المصطلح إلى عنصر سؤال يسمح للمجيب بأن يشير إلى تاريخ ووقت.
DestinationTypeتعداد يمثل أنواعًا معتمدة لوجهات استجابة النموذج.
DurationItemعنصر سؤال يسمح للمجيب بأن يشير إلى طول المدة الزمنية.
FeedbackTypeتعداد يمثل أنواع الملاحظات المعتمدة.
Formنموذج يحتوي على خصائص وعناصر عامة
FormAppتسمح هذه السياسة للنص البرمجي بفتح Form الحالي أو إنشاء نص جديد.
FormResponseرد على النموذج ككل.
GridItemعنصر سؤال يتم عرضه على شكل شبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيار واحد لكل صف من سلسلة من أزرار الاختيار.
GridValidationتم التحقُّق من صحة بيانات GridItem.
GridValidationBuilderمُنشئ بيانات صالح لـ GridValidation.
ImageItemعنصر في التنسيق يعرض صورة.
Itemعنصر عام للسمة يحتوي على خصائص جميع العناصر، مثل العنوان ونص المساعدة
ItemResponseرد على سؤال سؤال واحد ضمن نموذج.
ItemTypeتعداد يمثل أنواع عناصر النموذج المتوافقة.
ListItemعنصر سؤال يسمح للمجيب باختيار واحد من القائمة المنسدلة.
MultipleChoiceItemعنصر سؤال يسمح للمجيب باختيار واحد من قائمة أزرار الاختيار أو من حقل "غير ذلك" اختياري.
PageBreakItemعنصر تنسيق يمثّل بداية صفحة
PageNavigationTypeتعداد يمثّل الأنواع المتوافقة من التنقّل في الصفحات.
ParagraphTextItemعنصر سؤال يسمح للمجيب بإدخال مجموعة من النصوص.
ParagraphTextValidationتم التحقُّق من صحة بيانات ParagraphTextItem.
ParagraphTextValidationBuilderمُنشئ بيانات صالح لـ ParagraphTextValidation.
QuizFeedbackتطبيق الملاحظات والآراء، الذي يتضمّن خصائص شائعة لجميع الملاحظات، مثل نص العرض أو الروابط
QuizFeedbackBuilderأداة إنشاء الملاحظات الأساسية التي تحتوي على أدوات إعداد للسمات الشائعة لجميع الملاحظات، مثل نص العرض.
ScaleItemعنصر سؤال يسمح للمجيب باختيار خيار واحد من تسلسل رقمي لأزرار الاختيار.
SectionHeaderItemيشير هذا المصطلح إلى عنصر تنسيق يشير بشكل مرئي إلى بداية قسم.
TextItemعنصر سؤال يسمح للمجيب بإدخال سطر نص واحد.
TextValidationتم التحقُّق من صحة بيانات TextItem.
TextValidationBuilderمُنشئ بيانات صالح لـ TextValidation.
TimeItemعنصر سؤال يسمح للمجيب بأن يشير إلى وقت من اليوم.
VideoItemعنصر تنسيق يعرض فيديو.

Alignment

أماكن إقامة

الخاصيةTypeالوصف
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

أماكن إقامة

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

DurationItem

الطُرق

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

FeedbackType

أماكن إقامة

الخاصيةTypeالوصف
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لإضافة عنصر سؤال جديد يسمح للمجيب بإدخال مجموعة من النصوص.
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إرسال الدرجات لـ FormResponses المحددة.

FormApp

أماكن إقامة

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
create(title)Formتنشئ Form جديدة وتعرضها.
createCheckboxGridValidation()CheckboxGridValidationBuilderتعرض هذه السياسة مثيلًا لـ CheckboxGridvalidationBuilder الذي يمكن استخدامه لضبط حالة التحقّق على CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderتعرض هذه السياسة مثيلًا لـ CheckboxvalidationBuilder الذي يمكن استخدامه لضبط حالة التحقّق على CheckboxItem.
createFeedback()QuizFeedbackBuilderتعرض هذه السياسة مثيلًا لـ Quiz FeedbackBuilder الذي يمكن استخدامه لضبط الملاحظات على إحدى الدرجات Item.
createGridValidation()GridValidationBuilderتعرض هذه السياسة مثيلًا من GridvalidationBuilder الذي يمكن استخدامه لضبط التحقّق على GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderتعرض هذه السياسة مثيلًا لـ ParagraphTextvalidationBuilder الذي يمكن استخدامه لضبط التحقق على ParagraphTextItem.
createTextValidation()TextValidationBuilderتعرض هذه السياسة مثيلًا لـ TextvalidationBuilder الذي يمكن استخدامه لضبط التحقّق على TextItem.
getActiveForm()Formعرض النموذج الذي يرتبط به النص البرمجي container-bound
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

أماكن إقامة

الخاصيةTypeالوصف
CHECKBOXEnumعنصر سؤال يسمح للمجيب باختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى حقل "غير ذلك" اختياري.
CHECKBOX_GRIDEnumعنصر سؤال، يتم عرضه على شكل شبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيارات متعددة لكل صف من سلسلة من مربّعات الاختيار.
DATEEnumعنصر سؤال يسمح للمجيب بأن يشير إلى تاريخ.
DATETIMEEnumيشير هذا المصطلح إلى عنصر سؤال يسمح للمجيب بأن يشير إلى تاريخ ووقت.
DURATIONEnumعنصر سؤال يسمح للمجيب بأن يشير إلى طول المدة الزمنية.
GRIDEnumعنصر سؤال يتم عرضه على شكل شبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيار واحد لكل صف من سلسلة من أزرار الاختيار.
IMAGEEnumعنصر في التنسيق يعرض صورة.
LISTEnumعنصر سؤال يسمح للمجيب باختيار واحد من القائمة المنسدلة.
MULTIPLE_CHOICEEnumعنصر سؤال يسمح للمجيب باختيار واحد من قائمة أزرار الاختيار أو من حقل "غير ذلك" اختياري.
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).

أماكن إقامة

الخاصيةTypeالوصف
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لضبط عرض الفيديو بالبكسل.