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أداة DataفِيationBuilder لـ "CheckboxGridValidation"
CheckboxItemعنصر سؤال يسمح للمجيب بتحديد مربع اختيار واحد أو أكثر، بالإضافة إلى حقل اختياري "أخرى".
CheckboxValidationالتحقّق من صحة البيانات لـ CheckboxItem
CheckboxValidationBuilderأداة DataفِيationBuilder لـ "CheckboxValidation"
Choiceخيار واحد مرتبط بنوع Item يتيح خيارات، مثل CheckboxItem أو ListItem أو MultipleChoiceItem.
DateItemعنصر سؤال يسمح للمجيب بالإشارة إلى تاريخ.
DateTimeItemعنصر سؤال يسمح للمجيب بالإشارة إلى تاريخ ووقت.
DestinationTypeتعداد يمثّل الأنواع المتوافقة لوجهات الردود على النماذج.
DurationItemعنصر سؤال يسمح للمجيب بالإشارة إلى فترة زمنية.
FeedbackTypeيشير ذلك المصطلح إلى تعداد يمثّل الأنواع المتوافقة من الملاحظات.
Formيشير ذلك المصطلح إلى نموذج يحتوي على سمات وعناصر عامة.
FormAppيسمح هذا الإذن للنص البرمجي بفتح Form حالي أو إنشاء نص جديد.
FormResponseتمثّل هذه السمة ردًا على النموذج ككل.
GridItemعنصر سؤال، يتم تقديمه في شكل شبكة من الأعمدة والصفوف، يسمح للمجيب بتحديد خيار واحد لكل صف من سلسلة من أزرار الاختيار.
GridValidationالتحقّق من صحة البيانات لـ GridItem
GridValidationBuilderأداة DataفِيationBuilder لـ "GridValidation"
ImageItemعنصر تنسيق يعرض صورة.
Itemعنصر نموذج عام يحتوي على خصائص شائعة لكل العناصر، مثل العنوان ونص المساعدة.
ItemResponseالرد على عنصر سؤال واحد داخل نموذج.
ItemTypeتعداد يمثّل الأنواع المتوافقة لعناصر النموذج.
ListItemيشير ذلك المصطلح إلى عنصر سؤال يسمح للمجيب بتحديد خيار واحد من القائمة المنسدلة.
MultipleChoiceItemعنصر سؤال يسمح للمجيب بتحديد خيار واحد من قائمة أزرار الاختيار أو حقل "other" اختياري.
PageBreakItemيشير ذلك المصطلح إلى عنصر تنسيق يحدّد بداية صفحة معيَّنة.
PageNavigationTypeتعداد يمثّل الأنواع المتاحة للتنقّل في الصفحة.
ParagraphTextItemعنصر سؤال يسمح للمجيب بإدخال جزء من النص.
ParagraphTextValidationالتحقّق من صحة البيانات لـ ParagraphTextItem
ParagraphTextValidationBuilderأداة DataفِيationBuilder لـ "ParagraphTextValidation"
QuizFeedbackيشير ذلك المصطلح إلى تنفيذ ملاحظات الفاصوليا التي تتضمّن خصائص شائعة لكل الملاحظات، مثل النص المعروض أو الروابط.
QuizFeedbackBuilderيشير ذلك المصطلح إلى أداة FeedbackBuilder الأساسية التي تحتوي على مجموعات للخصائص المشتركة بين جميع الملاحظات، مثل النص المعروض.
ScaleItemعنصر سؤال يسمح للمجيب بتحديد خيار واحد من تسلسل مرقم لأزرار الاختيار.
SectionHeaderItemعنصر تخطيط يشير بصريًا إلى بداية قسم.
TextItemيشير ذلك المصطلح إلى عنصر سؤال يسمح للمجيب بإدخال سطر واحد من النص.
TextValidationالتحقّق من صحة البيانات لـ TextItem
TextValidationBuilderأداة DataفِيationBuilder لـ "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تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "other".
isRequired()Booleanتحدد ما إذا كان يجب على المجيب الإجابة على السؤال.
setChoiceValues(values)CheckboxItemلضبط الخيارات لعنصر من مصفوفة من السلاسل.
setChoices(choices)CheckboxItemلضبط مصفوفة من الخيارات لعنصر واحد.
setFeedbackForCorrect(feedback)CheckboxItemضبط الملاحظات بحيث يتم عرضها للمجيبين عندما يجيبون بشكل صحيح على سؤال.
setFeedbackForIncorrect(feedback)CheckboxItemضبط الملاحظات بحيث يتم عرضها للمجيبين عندما يجيبون بشكل غير صحيح على سؤال.
setHelpText(text)CheckboxItemتعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)CheckboxItemلضبط عدد النقاط التي يستحقها العنصر القابل لوضع درجات.
setRequired(enabled)CheckboxItemتحدِّد هذه السياسة ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)CheckboxItemلضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem).
setValidation(validation)CheckboxItemلتعيين التحقق من صحة البيانات لعنصر مربع الاختيار هذا.
showOtherOption(enabled)CheckboxItemلتحديد ما إذا كان العنصر يحتوي على خيار "غير ذلك".

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لإرفاق عنصر سؤال جديد يسمح للمجيب بتحديد مربع اختيار واحد أو أكثر، بالإضافة إلى حقل "other" اختياري.
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إرسال درجات لـ FormResponses المحددة

FormApp

أماكن إقامة

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
create(title)Formإنشاء Form جديد وعرضه.
createCheckboxGridValidation()CheckboxGridValidationBuilderتعرض مثيلاً من CheckboxGrid تطويرBuilder والذي يمكن استخدامه لضبط التحقق من الصحة على 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

أماكن إقامة

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