یک آیتم سوال که به پاسخ دهنده اجازه می دهد یک گزینه را از یک دنباله شماره گذاری دکمه های رادیویی انتخاب کند. آیتم ها را می توان از یک Form
مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد درجه بندی می شوند.
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
createResponse(response) | ItemResponse | یک ItemResponse جدید برای این آیتم مقیاس ایجاد می کند. |
duplicate() | ScaleItem | یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند. |
getGeneralFeedback() | QuizFeedback | بازخوردی را برمیگرداند که به پاسخدهندگان هنگام پاسخ دادن به یک سؤال قابل نمره نشان داده میشود. |
getHelpText() | String | متن راهنمای مورد را دریافت میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
getId() | Integer | شناسه منحصر به فرد مورد را دریافت می کند. |
getIndex() | Integer | نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند. |
getLeftLabel() | String | در صورت وجود، برچسب کران پایین ترازوی را دریافت می کند. |
getLowerBound() | Integer | کران پایین ترازوی را می گیرد. |
getPoints() | Integer | مقدار امتیاز یک مورد قابل نمره را برمیگرداند. |
getRightLabel() | String | در صورت وجود، برچسب کران بالای ترازو را دریافت می کند. |
getTitle() | String | عنوان مورد را دریافت می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
getType() | ItemType | نوع مورد را دریافت می کند که به صورت ItemType نمایش داده می شود. |
getUpperBound() | Integer | حد بالایی ترازو را می گیرد. |
isRequired() | Boolean | تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر. |
setBounds(lower, upper) | ScaleItem | مرزهای پایین و بالای ترازو را تنظیم می کند. |
setGeneralFeedback(feedback) | ScaleItem | بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود. |
setHelpText(text) | ScaleItem | متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
setLabels(lower, upper) | ScaleItem | برچسبهایی را برای مرزهای پایین و بالای ترازو تنظیم میکند. |
setPoints(points) | ScaleItem | تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. |
setRequired(enabled) | ScaleItem | تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر. |
setTitle(title) | ScaleItem | عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
مستندات دقیق
createResponse(response)
یک ItemResponse
جدید برای این آیتم مقیاس ایجاد می کند. اگر آرگومان response
خارج از محدوده تعیین شده برای آیتم باشد، یک استثنا ایجاد می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
response | Integer | یک پاسخ ارزشی برای این آیتم مقیاس |
برگشت
ItemResponse
- پاسخ مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
برگشت
ScaleItem
- تکراری از این ScaleItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
getLeftLabel()
در صورت وجود، برچسب کران پایین ترازوی را دریافت می کند.
برگشت
String
- برچسب کران پایین ترازوی
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getLowerBound()
کران پایین ترازوی را می گیرد.
برگشت
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
getRightLabel()
در صورت وجود، برچسب کران بالای ترازو را دریافت می کند.
برگشت
String
- برچسب کران بالای ترازو
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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()
getUpperBound()
حد بالایی ترازو را می گیرد.
برگشت
Integer
- کران بالای مقیاس
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
setBounds(lower, upper)
مرزهای پایین و بالای ترازو را تنظیم می کند. کران پایین باید 0
یا 1
باشد. کران بالا باید بین 3
تا 10
باشد، شامل. یک مقیاس جدید به طور پیشفرض، یک کران پایینی 1
و یک کران بالای 5
را نشان میدهد.
در صورتی که مقادیر داده شده خارج از محدودیت های مجاز باشند، یک استثنای اسکریپت ایجاد می کند. اعشار به عدد صحیح قبلی کوتاه می شوند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
lower | Integer | کران پایینی جدید |
upper | Integer | کران بالای جدید |
برگشت
ScaleItem
- این ScaleItem
، برای زنجیر کردن
پرتاب می کند
Error
- اگر کران پایین یا بالا نامعتبر باشد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
feedback | QuizFeedback | بازخورد جدید |
برگشت
ScaleItem
- این ScaleItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems
، PageBreakItems
و SectionHeaderItems
نامیده میشود).
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
text | String | متن راهنما جدید |
برگشت
ScaleItem
- این ScaleItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLabels(lower, upper)
برچسبهایی را برای مرزهای پایین و بالای ترازو تنظیم میکند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
lower | String | برچسب جدید برای کران پایین |
upper | String | برچسب جدید برای کران بالا |
برگشت
ScaleItem
- این ScaleItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
points | Integer | تعداد امتیاز یک مورد سوال ارزش دارد |
برگشت
ScaleItem
- این ScaleItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
enabled | Boolean | آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر |
برگشت
ScaleItem
- مورد فعلی (برای زنجیر کردن)
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem
).
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
title | String | عنوان یا متن سرصفحه جدید |
برگشت
ScaleItem
- این ScaleItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms