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

Class TimeItem

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

// Open a form by ID and add a new time item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addTimeItem();
item.setTitle('What time do you usually wake up in the morning?');

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`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`).

الوثائق التفصيلية

`createResponse(hour, minute)`

تنشئ سمة ItemResponse جديدة لعنصر الوقت هذا. يُفضَّل تمثيل الوسيطات hour وminute كأعداد صحيحة من 0 إلى 23 ومن 0 إلى 59، على التوالي. وإذا تجاوزت تلك الحدود، فإنها تتصرف مثل الساعة: على سبيل المثال، يتم تفسير 10, 90 على أنه 11:30، ويتم تفسير -1, 60 على أنه 00:00.

المعلمات

الاسم	النوع	الوصف
`hour`	`Integer`	الساعة، ممثلة كعدد صحيح من `0` إلى `23`
`minute`	`Integer`	الدقيقة من الساعة، ممثلة في شكل عدد صحيح من `0` إلى `59`

الإرجاع

ItemResponse — الرد على العنصر

التفويض

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

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

`duplicate()`

إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج

الإرجاع

TimeItem — نسخة طبق الأصل من TimeItem، للسلسلة

التفويض

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

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

`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`	الملاحظات الجديدة

الإرجاع

TimeItem — TimeItem هذا، للسلسلة

التفويض

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

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

`setHelpText(text)`

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

المعلمات

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

الإرجاع

TimeItem — TimeItem هذا، للسلسلة

التفويض

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

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

`setPoints(points)`

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

المعلمات

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

الإرجاع

TimeItem — TimeItem هذا، للسلسلة

التفويض

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

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

`setRequired(enabled)`

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

المعلمات

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

الإرجاع

TimeItem — العنصر الحالي (للسلسلة)

التفويض

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

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

`setTitle(title)`

تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem).

المعلمات

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

الإرجاع

TimeItem — TimeItem هذا، للسلسلة

التفويض

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

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