تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class RatingItem

عنصر سؤال يسمح للمجيب بتقديم تقييم. يمكن الوصول إلى العناصر أو إنشاؤها من Form. وعند استخدامها في اختبار، يتم تقييم هذه العناصر.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`createResponse(response)`	`ItemResponse`	لإنشاء `ItemResponse` جديدة لعنصر التقييم هذا
`duplicate()`	`RatingItem`	تُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
`getGeneralFeedback()`	`QuizFeedback`	تعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.
`getHelpText()`	`String`	للحصول على نص مساعدة السلعة (يُعرف أحيانًا باسم نص الوصف لعناصر التنسيق، مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`getId()`	`Integer`	الحصول على المعرّف الفريد للعنصر
`getIndex()`	`Integer`	تحصل على فهرس العنصر من بين جميع العناصر في النموذج.
`getPoints()`	`Integer`	لعرض قيمة النقاط لعنصر قابل للتصنيف.
`getRatingIcon()`	`RatingIconType`	الحصول على الرمز الذي تم اختياره للتقييم
`getRatingScaleLevel()`	`Integer`	تحصل على مستوى مقياس التقييم.
`getTitle()`	`String`	للحصول على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال `SectionHeaderItem`)
`getType()`	`ItemType`	تحصل على نوع العنصر الذي يتم تمثيله كـ `ItemType`.
`isRequired()`	`Boolean`	لتحديد ما إذا كان يجب على المجيب الإجابة عن السؤال.
`setGeneralFeedback(feedback)`	`RatingItem`	لضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
`setHelpText(text)`	`RatingItem`	لضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`setPoints(points)`	`RatingItem`	لضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
`setRatingIcon(ratingIcon)`	`RatingItem`	لضبط رمز التقييم
`setRatingScaleLevel(ratingScaleLevel)`	`RatingItem`	لضبط مستوى مقياس التقييم
`setRequired(enabled)`	`RatingItem`	لتحديد ما إذا كان على المجيب الإجابة عن السؤال.
`setTitle(title)`	`RatingItem`	لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال `SectionHeaderItem`)

مستندات تفصيلية

`createResponse(response)`

لإنشاء ItemResponse جديدة لعنصر التقييم هذا

يُعرِض استثناءً في النصوص البرمجية إذا كانت القيمة المقدَّمة لسمة response أقل من 1 أو أكبر من القيمة التي تعرضها سمةgetRatingScaleLevel().

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a new response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

المعلمات

الاسم	النوع	الوصف
`response`	`Integer`	قيمة الإجابة عن عنصر التقييم هذا.

الإرجاع

ItemResponse: استجابة السلعة.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`duplicate()`

تُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.

الإرجاع

RatingItem: نسخة طبق الأصل من هذا RatingItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getGeneralFeedback()`

تعرِض هذه السمة الملاحظات التي تظهر للمجيبين عند الردّ على سؤال قابل للتصنيف.

الإرجاع

QuizFeedback: الملاحظات، إن توفّرت.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getHelpText()`

للحصول على نص مساعدة السلعة (يُعرف أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

الإرجاع

String - نص المساعدة أو نص الوصف للعنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getId()`

الحصول على المعرّف الفريد للعنصر

الإرجاع

Integer: معرّف السلعة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getIndex()`

تحصل على فهرس العنصر من بين جميع العناصر في النموذج.

الإرجاع

Integer: فهرس العنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getPoints()`

لعرض قيمة النقاط لعنصر قابل للتصنيف.

الإرجاع

Integer: عدد النقاط التي يحصل عليها كل سؤال

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getRatingIcon()`

الحصول على الرمز الذي تم اختياره للتقييم

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

الإرجاع

‫RatingIconType: نوع رمز التقييم

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getRatingScaleLevel()`

تحصل على مستوى مقياس التقييم.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

الإرجاع

Integer — مستوى مقياس التقييم.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getTitle()`

للحصول على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem)

الإرجاع

String: عنوان السلعة أو نص العنوان

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

تحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.

الإرجاع

ItemType: نوع العنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isRequired()`

لتحديد ما إذا كان يجب على المجيب الإجابة عن السؤال.

الإرجاع

Boolean — ما إذا كان على المستجيب الإجابة عن السؤال

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setGeneralFeedback(feedback)`

لضبط الملاحظات التي ستظهر للمجيبين عند الردّ على سؤال قابل للتقييم ولكنه لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).

المعلمات

الاسم	النوع	الوصف
`feedback`	`QuizFeedback`	الملاحظات الجديدة

الإرجاع

RatingItem — هذا الرمز RatingItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setHelpText(text)`

لضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

المعلمات

الاسم	النوع	الوصف
`text`	`String`	نص المساعدة الجديد

الإرجاع

RatingItem — هذا الرمز RatingItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setPoints(points)`

لضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف. القيمة التلقائية للعناصر الجديدة هي 0.

المعلمات

الاسم	النوع	الوصف
`points`	`Integer`	عدد النقاط التي يستحقها عنصر السؤال

الإرجاع

RatingItem — هذا الرمز RatingItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRatingIcon(ratingIcon)`

لضبط رمز التقييم

يُعرِض استثناءً في النصوص البرمجية إذا كان نوع رمز التقييم غير صالح.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

المعلمات

الاسم	النوع	الوصف
`ratingIcon`	`RatingIconType`	نوع رمز التقييم

الإرجاع

RatingItem — هذا الرمز RatingItem، لإنشاء سلسلة.

عمليات الرمي

Error - إذا كان نوع رمز التقييم غير صالح

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRatingScaleLevel(ratingScaleLevel)`

لضبط مستوى مقياس التقييم يجب أن يتراوح مستوى مقياس التقييم بين 3 و10 شاملاً. يتم ضبط التقييم الجديد تلقائيًا على مستوى مقياس التقييم 3.

يُرسِل استثناءً للنص البرمجي إذا كانت القيم المقدَّمة خارج الحدود المسموح بها.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

المعلمات

الاسم	النوع	الوصف
`ratingScaleLevel`	`Integer`	مستوى مقياس التقييم

الإرجاع

RatingItem — هذا الرمز RatingItem، لإنشاء سلسلة.

عمليات الرمي

Error - إذا كان مستوى مقياس التقييم غير صالح

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRequired(enabled)`

لتحديد ما إذا كان على المجيب الإجابة عن السؤال.

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	ما إذا كان على المجيب الإجابة عن السؤال

الإرجاع

RatingItem: العنصر الحالي (للتسلسل)

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setTitle(title)`

لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem)

المعلمات

الاسم	النوع	الوصف
`title`	`String`	العنوان الجديد أو نص العنوان

الإرجاع

RatingItem — هذا الرمز RatingItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms