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

Class DurationItem

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

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

المَعلمات

الاسم	Type	الوصف
`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)`

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

المَعلمات

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

استرجاع الكرة

DurationItem — جهاز DurationItem هذا للسلاسل

التفويض

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

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

`setHelpText(text)`

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

المَعلمات

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

استرجاع الكرة

DurationItem — جهاز DurationItem هذا للسلاسل

التفويض

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

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

`setPoints(points)`

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

المَعلمات

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

استرجاع الكرة

DurationItem — جهاز DurationItem هذا للسلاسل

التفويض

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

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

`setRequired(enabled)`

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`setTitle(title)`

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

المَعلمات

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

استرجاع الكرة

DurationItem — جهاز DurationItem هذا للسلاسل

التفويض

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

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