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

Class TimeItem

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

// Open a form by ID and add a new time item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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