سوالی که به پاسخ دهنده اجازه می دهد مدت زمان را مشخص کند. آیتم ها را می توان از یک Form
مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد درجه بندی می شوند.
// Open a form by ID and add a new duration item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
create Response(hours, minutes, seconds) | Item Response | یک Item Response جدید برای این مورد تاریخ ایجاد می کند. |
duplicate() | Duration Item | یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند. |
get General Feedback() | Quiz Feedback | بازخوردی را برمیگرداند که به پاسخدهندگان هنگام پاسخ دادن به یک سؤال قابل نمره نشان داده میشود. |
get Help Text() | String | متن راهنمای مورد را دریافت میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند Image Items ، Page Break Items و Section Header Items نامیده میشود). |
get Id() | Integer | شناسه منحصر به فرد مورد را دریافت می کند. |
get Index() | Integer | نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند. |
get Points() | Integer | مقدار امتیاز یک مورد قابل نمره را برمیگرداند. |
get Title() | String | عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item ). |
get Type() | Item Type | نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود. |
is Required() | Boolean | تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر. |
set General Feedback(feedback) | Duration Item | بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود. |
set Help Text(text) | Duration Item | متن راهنمای مورد را تنظیم میکند (گاهی اوقات به آن متن توضیحات برای موارد طرحبندی مانند Image Items ، Page Break Items و Section Header Items گفته میشود). |
set Points(points) | Duration Item | تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. |
set Required(enabled) | Duration Item | تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر. |
set Title(title) | Duration Item | عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ). |
مستندات دقیق
create Response(hours, minutes, seconds)
یک Item Response
جدید برای این مورد تاریخ ایجاد می کند. آرگومان های hours
, minutes
, و seconds
به بهترین شکل به صورت اعداد صحیح از 0
تا 72
برای hours
و 0
تا 59
برای minutes
و seconds
نمایش داده می شوند. مقادیری که بیش از این مرزها هستند، گیره می شوند: برای مثال، 24, 60, 90
به عنوان 24:59:59 تفسیر می شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
hours | Integer | ساعت، به عنوان یک عدد صحیح از 0 تا 72 نشان داده شده است |
minutes | Integer | دقیقه، به عنوان یک عدد صحیح از 0 تا 59 نشان داده شده است |
seconds | Integer | ثانیه ها به صورت یک عدد صحیح از 0 تا 59 نشان داده شده است |
بازگشت
Item Response
- پاسخ مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
بازگشت
Duration Item
- تکراری از این Duration Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get General Feedback()
بازخوردی را برمیگرداند که به پاسخدهندگان هنگام پاسخ دادن به یک سؤال قابل نمره نشان داده میشود.
بازگشت
Quiz Feedback
- بازخورد، در صورت وجود.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Help Text()
متن راهنمای مورد را دریافت میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند Image Items
، Page Break Items
و Section Header Items
نامیده میشود).
بازگشت
String
- متن راهنمای مورد یا متن توضیحات
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Id()
شناسه منحصر به فرد مورد را دریافت می کند.
بازگشت
Integer
- شناسه مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Index()
نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.
بازگشت
Integer
- شاخص مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Points()
مقدار امتیاز یک مورد قابل نمره را برمیگرداند.
بازگشت
Integer
- تعداد امتیازهایی که یک سوال ارزش دارد.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Title()
عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item
).
بازگشت
String
- عنوان یا متن سرصفحه مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Type()
is Required()
تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
بازگشت
Boolean
- آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set General Feedback(feedback)
بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
feedback | Quiz Feedback | بازخورد جدید |
بازگشت
Duration Item
- این Duration Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
متن راهنمای مورد را تنظیم میکند (گاهی اوقات به آن متن توضیحات برای موارد طرحبندی مانند Image Items
، Page Break Items
و Section Header Items
گفته میشود).
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text | String | متن راهنما جدید |
بازگشت
Duration Item
- این Duration Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
points | Integer | تعداد امتیاز یک مورد سوال ارزش دارد |
بازگشت
Duration Item
- این Duration Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
enabled | Boolean | آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر |
بازگشت
Duration Item
- مورد فعلی (برای زنجیر کردن)
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item
).
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
title | String | عنوان یا متن سرصفحه جدید |
بازگشت
Duration Item
- این Duration Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms