Class DateItem

DateItem

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

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
createResponse(response)ItemResponseينشئ عنصر ItemResponse جديدًا لعنصر التاريخ هذا.
duplicate()DateItemلإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
getGeneralFeedback()QuizFeedbackتعرض الملاحظات التي يتم عرضها للمستجيبين عند الرد على سؤال يمكن وضع درجات له.
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، يتم تجاهل السنة أيضًا.

المَعلمات

الاسمTypeالوصف
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: الملاحظات، إن توفّرت

التفويض

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

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

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

المَعلمات

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

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

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

التفويض

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

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

setHelpText(text)

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

المَعلمات

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

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

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

التفويض

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

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

setIncludesYear(enableYear)

لتحديد ما إذا كان عنصر التاريخ يتضمن إعداد السنة. الإعداد التلقائي لعناصر التاريخ الجديدة هو true.

المَعلمات

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

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

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

التفويض

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

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

setPoints(points)

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

المَعلمات

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

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

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

التفويض

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

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

setRequired(enabled)

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

المَعلمات

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

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

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

التفويض

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

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

setTitle(title)

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

المَعلمات

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

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

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

التفويض

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

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