یک آیتم سوال که به پاسخ دهنده اجازه می دهد یک بلوک متن را وارد کند. آیتم ها را می توان از یک Form
مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد درجه بندی می شوند.
// Open a form by ID and add a new paragraph text item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addParagraphTextItem(); item.setTitle('What is your address?');
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
clear Validation() | Paragraph Text Item | هر گونه اعتبارسنجی داده را برای این مورد متنی پاراگراف حذف می کند. |
create Response(response) | Item Response | یک Item Response جدید برای این آیتم متنی پاراگراف ایجاد می کند. |
duplicate() | Paragraph Text 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) | Paragraph Text Item | بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود. |
set Help Text(text) | Paragraph Text Item | متن راهنمای مورد را تنظیم میکند (گاهی اوقات به آن متن توضیحات برای موارد طرحبندی مانند Image Items ، Page Break Items و Section Header Items گفته میشود). |
set Points(points) | Paragraph Text Item | تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. |
set Required(enabled) | Paragraph Text Item | تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر. |
set Title(title) | Paragraph Text Item | عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ). |
set Validation(validation) | Paragraph Text Item | اعتبار داده ها را برای این مورد متنی پاراگراف تنظیم می کند. |
مستندات دقیق
clear Validation()
هر گونه اعتبارسنجی داده را برای این مورد متنی پاراگراف حذف می کند.
بازگشت
Paragraph Text Item
- این Paragraph Text Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
create Response(response)
یک Item Response
جدید برای این آیتم متنی پاراگراف ایجاد می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
response | String | پاسخ به سوال مطرح شده توسط آیتم |
بازگشت
Item Response
- پاسخ مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
بازگشت
Paragraph Text Item
- تکراری از این Paragraph Text 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 | بازخورد جدید |
بازگشت
Paragraph Text Item
- این Paragraph Text 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 | متن راهنما جدید |
بازگشت
Paragraph Text Item
- این Paragraph Text Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
points | Integer | تعداد امتیاز یک مورد سوال ارزش دارد |
بازگشت
Paragraph Text Item
- این Paragraph Text Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
enabled | Boolean | آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر |
بازگشت
Paragraph Text Item
- مورد فعلی (برای زنجیر کردن)
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item
).
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
title | String | عنوان یا متن سرصفحه جدید |
بازگشت
Paragraph Text Item
- این Paragraph Text Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Validation(validation)
اعتبار داده ها را برای این مورد متنی پاراگراف تنظیم می کند. ارسال null یا اعتبارسنجی بدون نیاز به توابع فراخوانی شده، هرگونه اعتبارسنجی قبلی را حذف می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
validation | Paragraph Text Validation | یک ParagraphTextValidation برای اعمال به این مورد. |
بازگشت
Paragraph Text Item
- این Paragraph Text Item
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms