تسمح هذه الخدمة للنصوص بإنشاء "نماذج 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 | الوصف |
---|---|---|
LEFT | Enum | محاذاة الصورة إلى الجانب الأيمن من النموذج. |
CENTER | Enum | محاذاة الصورة إلى منتصف النموذج |
RIGHT | Enum | محاذاة الصورة إلى الجانب الأيمن من النموذج. |
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 | الوصف |
---|---|---|
SPREADSHEET | Enum | جدول بيانات "جداول بيانات 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 | الوصف |
---|---|---|
CORRECT | Enum | الملاحظات التي يتم عرضها تلقائيًا للمجيبين عن سؤال تمت الإجابة عنه بشكل صحيح. |
INCORRECT | Enum | التعليقات التي يتم عرضها تلقائيًا للمجيبين عن سؤال تمت الإجابة عنه بشكل غير صحيح. |
GENERAL | Enum | التعليقات التي يتم عرضها تلقائيًا للمجيبين عند إرسال ردهم. |
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 | الوصف |
---|---|---|
Alignment | Alignment | تعداد لأنواع محاذاة الصور |
DestinationType | DestinationType | تعداد لأنواع الوجهات التي يمكنها تخزين الردود على النماذج. |
FeedbackType | FeedbackType | تعداد أنواع Feedbacks |
ItemType | ItemType | تعداد أنواع Items |
PageNavigationType | PageNavigationType | تعداد للسلوكيات المحتملة للتنقّل بين الصفحات |
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
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 | الوصف |
---|---|---|
CHECKBOX | Enum | عنصر سؤال يسمح للمجيب باختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى حقل "غير ذلك" اختياري. |
CHECKBOX_GRID | Enum | عنصر سؤال، يتم عرضه على شكل شبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيارات متعددة لكل صف من سلسلة من مربّعات الاختيار. |
DATE | Enum | عنصر سؤال يسمح للمجيب بأن يشير إلى تاريخ. |
DATETIME | Enum | يشير هذا المصطلح إلى عنصر سؤال يسمح للمجيب بأن يشير إلى تاريخ ووقت. |
DURATION | Enum | عنصر سؤال يسمح للمجيب بأن يشير إلى طول المدة الزمنية. |
GRID | Enum | عنصر سؤال يتم عرضه على شكل شبكة من الأعمدة والصفوف، ويسمح للمجيب باختيار خيار واحد لكل صف من سلسلة من أزرار الاختيار. |
IMAGE | Enum | عنصر في التنسيق يعرض صورة. |
LIST | Enum | عنصر سؤال يسمح للمجيب باختيار واحد من القائمة المنسدلة. |
MULTIPLE_CHOICE | Enum | عنصر سؤال يسمح للمجيب باختيار واحد من قائمة أزرار الاختيار أو من حقل "غير ذلك" اختياري. |
PAGE_BREAK | Enum | عنصر تنسيق يمثّل بداية صفحة |
PARAGRAPH_TEXT | Enum | عنصر سؤال يسمح للمجيب بإدخال مجموعة من النصوص. |
SCALE | Enum | عنصر سؤال يسمح للمجيب باختيار خيار واحد من تسلسل رقمي لأزرار الاختيار. |
SECTION_HEADER | Enum | يشير هذا المصطلح إلى عنصر تنسيق يشير بشكل مرئي إلى بداية قسم. |
TEXT | Enum | عنصر سؤال يسمح للمجيب بإدخال سطر نص واحد. |
TIME | Enum | عنصر سؤال يسمح للمجيب بأن يشير إلى وقت من اليوم. |
VIDEO | Enum | عنصر تنسيق يعرض فيديو على YouTube. |
FILE_UPLOAD | Enum | عنصر سؤال يسمح للمجيب بتحميل ملف. |
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 ). |
PageNavigationType
أماكن إقامة
الخاصية | Type | الوصف |
---|---|---|
CONTINUE | Enum | المتابعة إلى الصفحة التالية من النموذج بعد إكمال الصفحة الحالية |
GO_TO_PAGE | Enum | الانتقال إلى صفحة محدّدة من النموذج بعد إكمال الصفحة الحالية |
RESTART | Enum | أعِد تشغيل النموذج من البداية، بدون محو الإجابات التي تم إدخالها حتى الآن، بعد إكمال الصفحة الحالية. |
SUBMIT | Enum | أرسِل الرد على النموذج بعد إكمال الصفحة الحالية. |
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
الطُرق
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 | لضبط عرض الفيديو بالبكسل. |