Class TimeItem

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|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
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.

المَعلمات

الاسمالنوعالوصف
hourIntegerالساعة، ويتم تمثيلها كعدد صحيح من 0 إلى 23
minuteIntegerدقيقة الساعة، ويتم تمثيلها كعدد صحيح من 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|null: الملاحظات، إن وُجدت.

التفويض

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

  • 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)

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

المَعلمات

الاسمالنوعالوصف
feedbackQuizFeedbackالملاحظات الجديدة

الإرجاع

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

التفويض

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

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

setHelpText(text)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

setPoints(points)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

setRequired(enabled)

تضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال.

المَعلمات

الاسمالنوعالوصف
enabledBooleanما إذا كان على المشارك الإجابة عن السؤال

الإرجاع

‫TimeItem: العنصر الحالي (لربط السلسلة)

التفويض

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

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

setTitle(title)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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