Class DateItem

DateItem

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

// Open a form by ID and add a new date item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateItem();
item.setTitle('When were you born?');

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
createResponse(response)ItemResponseتُنشئ هذه السمة ItemResponse جديدًا لعنصر التاريخ هذا.
duplicate()DateItemينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.
getGeneralFeedback()QuizFeedback|nullتعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
getHelpText()Stringتعرض هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerتعرض هذه الطريقة المعرّف الفريد للعنصر.
getIndex()Integerتعرض هذه السمة فهرس العنصر بين جميع العناصر في النموذج.
getPoints()Integerتعرض هذه السمة قيمة النقاط الخاصة بعنصر قابل للتقييم.
getTitle()Stringتعرض هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).
getType()ItemTypeتعرض هذه السمة نوع العنصر، ويتم تمثيله كـ ItemType.
includesYear()Booleanتحدّد ما إذا كان عنصر التاريخ يتضمّن خيار السنة.
isRequired()Booleanتحدّد ما إذا كان يجب على المستجيب الإجابة عن السؤال.
setGeneralFeedback(feedback)DateItemتضبط هذه السمة الملاحظات التي ستظهر للمجيبين عند الإجابة عن سؤال قابل للتقييم لا يتضمّن إجابة صحيحة أو غير صحيحة (أي الأسئلة التي تتطلّب تقييمًا يدويًا).
setHelpText(text)DateItemتضبط هذه السمة نص المساعدة الخاص بالعنصر (يُطلق عليه أحيانًا اسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setIncludesYear(enableYear)DateItemتضبط هذه السمة ما إذا كان عنصر التاريخ يتضمّن إعدادًا للسنة.
setPoints(points)DateItemتضبط هذه السمة عدد النقاط التي يستحقها عنصر قابل للتقييم.
setRequired(enabled)DateItemتضبط هذه السمة ما إذا كان على المستجيب الإجابة عن السؤال.
setTitle(title)DateItemتضبط هذه السمة عنوان العنصر (يُطلق عليه أحيانًا اسم نص العنوان، في حالة SectionHeaderItem).

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

createResponse(response)

تُنشئ هذه السمة ItemResponse جديدًا لعنصر التاريخ هذا. يتم تجاهل حقول الوقت الخاصة بالكائن Date ، وبشكل تلقائي، يتم استخدام حقول السنة والشهر واليوم فقط. إذا تم ضبط setIncludesYear(enabled) على false، سيتم تجاهل السنة أيضًا.

المَعلمات

الاسمالنوعالوصف
responseDateكائن Date يمثّل الشهر واليوم والسنة (اختياري)

الإرجاع

‫ItemResponse: استجابة العنصر

التفويض

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

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

duplicate()

ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.

الإرجاع

‫DateItem: نسخة مكرّرة من DateItem، لتسلسل العمليات

التفويض

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

  • 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

includesYear()

تحدّد ما إذا كان عنصر التاريخ يتضمّن خيار السنة.

الإرجاع

‫Boolean — true إذا كان التاريخ يتضمّن إعداد السنة، false إذا لم يكن كذلك

التفويض

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

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

الإرجاع

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

التفويض

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

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

setHelpText(text)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

setIncludesYear(enableYear)

تضبط هذه السمة ما إذا كان عنصر التاريخ يتضمّن إعدادًا للسنة. القيمة التلقائية لعناصر التاريخ الجديدة هي true.

المَعلمات

الاسمالنوعالوصف
enableYearBooleantrue إذا كان التاريخ يتضمّن إعداد السنة، false إذا لم يكن كذلك

الإرجاع

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

التفويض

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

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

setPoints(points)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

setRequired(enabled)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

setTitle(title)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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