سوالی که به پاسخ دهنده اجازه می دهد تاریخ و زمان را مشخص کند. آیتم ها را می توان از یک Form
مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد درجه بندی می شوند.
// Open a form by ID and add a new date-time item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDateTimeItem(); item.setTitle('When do you want to meet?');
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
createResponse(response) | ItemResponse | یک ItemResponse جدید برای این آیتم تاریخ-زمان ایجاد می کند. |
duplicate() | DateTimeItem | یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند. |
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) | DateTimeItem | بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود. |
setHelpText(text) | DateTimeItem | متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
setIncludesYear(enableYear) | DateTimeItem | تعیین می کند که آیا مورد تاریخ شامل تنظیم سال باشد یا خیر. |
setPoints(points) | DateTimeItem | تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. |
setRequired(enabled) | DateTimeItem | تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر. |
setTitle(title) | DateTimeItem | عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
مستندات دقیق
createResponse(response)
یک ItemResponse
جدید برای این آیتم تاریخ-زمان ایجاد می کند. فیلد ثانیه شی Date
نادیده گرفته می شود. به طور پیش فرض از فیلدهای سال، ماه، روز، ساعت و دقیقه استفاده می شود. اگر setIncludesYear(enabled)
روی false
تنظیم شود، سال نیز نادیده گرفته می شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
response | Date | یک شیء Date که یک ماه، روز، ساعت، دقیقه و احتمالاً سال را نشان می دهد |
برگشت
ItemResponse
- پاسخ مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
برگشت
DateTimeItem
- تکراری از این DateTimeItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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()
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)
بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
feedback | QuizFeedback | بازخورد جدید |
برگشت
DateTimeItem
- این DateTimeItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems
، PageBreakItems
و SectionHeaderItems
نامیده میشود).
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
text | String | متن راهنما جدید |
برگشت
DateTimeItem
- این DateTimeItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIncludesYear(enableYear)
تعیین می کند که آیا مورد تاریخ شامل تنظیم سال باشد یا خیر. پیش فرض برای آیتم های تاریخ جدید true
است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
enableYear | Boolean | true اگر تاریخ شامل تنظیم سال باشد. false اگر نه |
برگشت
DateTimeItem
- این DateTimeItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
points | Integer | تعداد امتیاز یک مورد سوال ارزش دارد |
برگشت
DateTimeItem
- این DateTimeItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
enabled | Boolean | آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر |
برگشت
DateTimeItem
- مورد فعلی (برای زنجیر کردن)
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem
).
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
title | String | عنوان یا متن سرصفحه جدید |
برگشت
DateTimeItem
- این DateTimeItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms