عنصر سؤال يتيح للمجيب تقديم تقييم. يمكن الوصول إلى العناصر أو إنشاؤها من 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);
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
create | Item | تُنشئ هذه السمة Item جديدًا لعنصر التقييم هذا. |
duplicate() | Rating | ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج. |
get | Quiz | تعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم. |
get | String | تعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل Image وPage وSection ). |
get | Integer | تعرض هذه الطريقة المعرّف الفريد للعنصر. |
get | Integer | تعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج. |
get | Integer | تعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم. |
get | Rating | تعرض هذه السمة الرمز الذي تم اختياره للتقييم. |
get | Integer | تعرض هذه السمة مستوى مقياس التقييم. |
get | String | تعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا نص العنوان، في حالة Section ). |
get | Item | تعرض هذه السمة نوع العنصر، ويتم تمثيله كـ Item . |
is | Boolean | تحدّد ما إذا كان على المستجيب الإجابة عن السؤال. |
set | Rating | تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عند الإجابة عن سؤال قابل للتقييم لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا). |
set | Rating | تضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل Image وPage وSection ). |
set | Rating | تضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم. |
set | Rating | تضبط هذه السمة رمز التقييم. |
set | Rating | تضبط هذه السمة الحد الأقصى لمستوى المقياس. |
set | Rating | تضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال. |
set | Rating | تضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، كما هو الحال في Section ). |
مستندات مفصّلة
create Response(response)
تُنشئ هذه السمة Item
جديدًا لعنصر التقييم هذا.
يتم عرض استثناء في البرمجة النصية إذا كانت قيمة response
المقدَّمة أقل من 1
أو أكبر من القيمة التي تعرضها get
.
// Open a form by ID const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Get an existing rating item and create a response for it. const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem(); const response =item.createResponse(5);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
response | Integer | تمثّل هذه السمة إجابة ذات قيمة لعنصر التقييم هذا. |
الإرجاع
Item
: استجابة العنصر
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.
الإرجاع
Rating
: نسخة مكرّرة من Rating
، لتسلسل العمليات
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get General Feedback()
تعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
الإرجاع
Quiz
: الملاحظات، إن وُجدت.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Help Text()
تعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل Image
وPage
وSection
).
الإرجاع
String
— نص المساعدة أو نص الوصف الخاص بالعنصر
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Id()
تعرض هذه الطريقة المعرّف الفريد للعنصر.
الإرجاع
Integer
: معرّف السلعة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Index()
تعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج.
الإرجاع
Integer
: فهرس العنصر
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Points()
تعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم.
الإرجاع
Integer
: عدد النقاط التي يستحقها السؤال
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Rating Icon()
تعرض هذه السمة الرمز الذي تم اختياره للتقييم.
// 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();
الإرجاع
Rating
: نوع رمز التقييم
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Rating Scale Level()
تعرض هذه السمة مستوى مقياس التقييم.
// 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
get Title()
تعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا نص العنوان، في حالة Section
).
الإرجاع
String
: عنوان السلعة أو نص العنوان
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Type()
is Required()
تحدّد ما إذا كان على المستجيب الإجابة عن السؤال.
الإرجاع
Boolean
— ما إذا كان على المشارك الإجابة عن السؤال
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set General Feedback(feedback)
تضبط هذه السمة الملاحظات التي ستظهر للمجيبين عند الإجابة عن سؤال قابل للتقييم لا يتضمّن إجابة صحيحة أو خاطئة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
المعلمات
الاسم | النوع | الوصف |
---|---|---|
feedback | Quiz | الملاحظات الجديدة |
الإرجاع
Rating
— هذا Rating
، للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
تضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل Image
وPage
وSection
).
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
الإرجاع
Rating
— هذا Rating
، للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
تضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم. القيمة التلقائية للعناصر الجديدة هي 0.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
points | Integer | عدد النقاط التي يستحقها عنصر السؤال |
الإرجاع
Rating
— هذا Rating
، للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Rating Icon(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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
rating | Rating | نوع رمز التقييم |
الإرجاع
Rating
: هذا Rating
، يُستخدَم للربط.
الرميات
Error
: إذا كان نوع رمز التقييم غير صالح
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Rating Scale Level(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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
rating | Integer | مستوى مقياس التقييم |
الإرجاع
Rating
: هذا Rating
، يُستخدَم للربط.
الرميات
Error
: إذا كان مستوى مقياس التقييم غير صالح
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
تضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان على المشارك الإجابة عن السؤال |
الإرجاع
Rating
: العنصر الحالي (لربط السلاسل)
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
تضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، كما هو الحال في Section
).
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
الإرجاع
Rating
— هذا Rating
، للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms