Class DurationItem

المدةالعنصر

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

// Open a form by ID and add a new duration item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDurationItem();
item.setTitle('How long can you hold your breath?');

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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)

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

createResponse(hours, minutes, seconds)

تُنشئ هذه السمة ItemResponse جديدة لعنصر التاريخ هذا. من الأفضل تمثيل الوسيطات hours وminutes وseconds كأعداد صحيحة من 0 إلى 72 لسمة hours و0 إلى 59 لسمةminutes وseconds. يتمّ اقتطاع القيم التي تتجاوز هذه الحدود: على سبيل المثال، يتمّ تفسير 24, 60, 90 على أنّه 24:59:59.

المعلمات

الاسم	النوع	الوصف
hours	Integer	الساعات، التي يتم تمثيلها كعدد صحيح من 0 إلى 72
minutes	Integer	الدقائق، التي يتم تمثيلها كعدد صحيح من 0 إلى 59
seconds	Integer	الثواني، يتم تمثيلها كعدد صحيح من 0 إلى 59

الإرجاع

ItemResponse - استجابة السلعة

التفويض

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

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

---

duplicate()

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

الإرجاع

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

التفويض

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

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

الإرجاع

DurationItem — هذا DurationItem، لإنشاء سلسلة

التفويض

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

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

---

setHelpText(text)

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

المعلمات

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

الإرجاع

DurationItem — هذا DurationItem، لإنشاء سلسلة

التفويض

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

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

---

setPoints(points)

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

المعلمات

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

الإرجاع

DurationItem — هذا DurationItem، لإنشاء سلسلة

التفويض

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

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

---

setRequired(enabled)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setTitle(title)

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

المعلمات

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

الإرجاع

DurationItem — هذا DurationItem، لإنشاء سلسلة

التفويض

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

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