یک آیتم سوال که به پاسخ دهنده اجازه می دهد یک بلوک متن را وارد کند. آیتم ها را می توان از یک Form
مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد درجه بندی می شوند.
// Open a form by ID and add a new paragraph text item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addParagraphTextItem(); item.setTitle('What is your address?');
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
clearValidation() | ParagraphTextItem | هر گونه اعتبارسنجی داده را برای این مورد متنی پاراگراف حذف می کند. |
createResponse(response) | ItemResponse | یک ItemResponse جدید برای این آیتم متنی پاراگراف ایجاد می کند. |
duplicate() | ParagraphTextItem | یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند. |
getGeneralFeedback() | QuizFeedback | بازخوردی را برمیگرداند که به پاسخدهندگان هنگام پاسخ دادن به یک سؤال قابل نمره نشان داده میشود. |
getHelpText() | String | متن راهنمای مورد را دریافت میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
getId() | Integer | شناسه منحصر به فرد مورد را دریافت می کند. |
getIndex() | Integer | نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند. |
getPoints() | Integer | مقدار امتیاز یک مورد قابل نمره را برمیگرداند. |
getTitle() | String | عنوان مورد را دریافت می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
getType() | ItemType | نوع مورد را دریافت می کند که به صورت ItemType نمایش داده می شود. |
isRequired() | Boolean | تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر. |
setGeneralFeedback(feedback) | ParagraphTextItem | بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود. |
setHelpText(text) | ParagraphTextItem | متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
setPoints(points) | ParagraphTextItem | تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. |
setRequired(enabled) | ParagraphTextItem | تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر. |
setTitle(title) | ParagraphTextItem | عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
setValidation(validation) | ParagraphTextItem | اعتبار داده ها را برای این مورد متنی پاراگراف تنظیم می کند. |
مستندات دقیق
clearValidation()
هر گونه اعتبارسنجی داده را برای این مورد متنی پاراگراف حذف می کند.
بازگشت
ParagraphTextItem
- این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
یک ItemResponse
جدید برای این آیتم متنی پاراگراف ایجاد می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
response | String | پاسخ به سوال مطرح شده توسط آیتم |
بازگشت
ItemResponse
- پاسخ مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
بازگشت
ParagraphTextItem
- تکراری از این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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()
isRequired()
تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
بازگشت
Boolean
- آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
feedback | QuizFeedback | بازخورد جدید |
بازگشت
ParagraphTextItem
- این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems
، PageBreakItems
و SectionHeaderItems
نامیده میشود).
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text | String | متن راهنما جدید |
بازگشت
ParagraphTextItem
- این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
points | Integer | تعداد امتیاز یک مورد سوال ارزش دارد |
بازگشت
ParagraphTextItem
- این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
enabled | Boolean | آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر |
بازگشت
ParagraphTextItem
- مورد فعلی (برای زنجیره زدن)
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem
).
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
title | String | عنوان یا متن سرصفحه جدید |
بازگشت
ParagraphTextItem
- این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
اعتبار سنجی داده ها را برای این مورد متنی پاراگراف تنظیم می کند. ارسال null یا اعتبارسنجی بدون نیاز به توابع فراخوانی شده، هرگونه اعتبارسنجی قبلی را حذف می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
validation | ParagraphTextValidation | یک ParagraphTextValidation برای اعمال به این مورد. |
بازگشت
ParagraphTextItem
- این ParagraphTextItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms