تسمح هذه الخدمة للنصوص البرمجية بإنشاء "نماذج 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 | الوصف |
---|---|---|
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 | تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "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 | الوصف |
---|---|---|
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 | لإرفاق عنصر سؤال جديد يسمح للمجيب بتحديد مربع اختيار واحد أو أكثر، بالإضافة إلى حقل "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 | الوصف |
---|---|---|
Alignment | Alignment | تعداد لأنواع محاذاة الصور. |
DestinationType | DestinationType | تعداد لأنواع الوجهات التي يمكنها تخزين الردود على النماذج |
FeedbackType | FeedbackType | تعداد لأنواع النموذج Feedbacks . |
ItemType | ItemType | تعداد لأنواع النموذج Items . |
PageNavigationType | PageNavigationType | قائمة بالسلوكيات المحتملة للتنقل في الصفحات. |
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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 | الوصف |
---|---|---|
CHECKBOX | Enum | عنصر سؤال يسمح للمجيب بتحديد مربع اختيار واحد أو أكثر، بالإضافة إلى حقل اختياري "أخرى". |
CHECKBOX_GRID | Enum | عنصر سؤال يتم تقديمه في شكل شبكة من الأعمدة والصفوف، يسمح للمجيب بتحديد عدة خيارات لكل صف من سلسلة من مربعات الاختيار. |
DATE | Enum | عنصر سؤال يسمح للمجيب بالإشارة إلى تاريخ. |
DATETIME | Enum | عنصر سؤال يسمح للمجيب بالإشارة إلى تاريخ ووقت. |
DURATION | Enum | عنصر سؤال يسمح للمجيب بالإشارة إلى فترة زمنية. |
GRID | Enum | عنصر سؤال، يتم تقديمه في شكل شبكة من الأعمدة والصفوف، يسمح للمجيب بتحديد خيار واحد لكل صف من سلسلة من أزرار الاختيار. |
IMAGE | Enum | عنصر تنسيق يعرض صورة. |
LIST | Enum | يشير ذلك المصطلح إلى عنصر سؤال يسمح للمجيب بتحديد خيار واحد من القائمة المنسدلة. |
MULTIPLE_CHOICE | Enum | عنصر سؤال يسمح للمجيب بتحديد خيار واحد من قائمة أزرار الاختيار أو حقل "other" اختياري. |
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 | تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "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 ). |
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 | لتعيين عرض الفيديو بالبكسل. |