Class MultipleChoiceItem

آیتم چند گزینه ای

یک آیتم سوال که به پاسخ دهنده اجازه می دهد یک گزینه را از لیست دکمه های رادیویی یا یک فیلد اختیاری "دیگر" انتخاب کند. آیتم ها را می توان از یک Form مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد به صورت خودکار درجه بندی می شوند. 

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([item.createChoice('Cats'), item.createChoice('Dogs')])
    .showOtherOption(true);

روش ها

روش نوع برگشت شرح مختصر
create Choice(value) Choice انتخاب جدیدی ایجاد می کند.
create Choice(value, isCorrect) Choice انتخاب جدیدی ایجاد می کند.
create Choice(value, navigationItem) Choice یک انتخاب جدید با یک گزینه پیمایش صفحه ایجاد می کند که به یک آیتم قطع صفحه می پرد.
create Choice(value, navigationType) Choice یک انتخاب جدید با یک گزینه پیمایش صفحه ایجاد می کند.
create Response(response) Item Response یک Item Response جدید برای این آیتم چند گزینه ای ایجاد می کند.
duplicate() Multiple Choice Item یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
get Choices() Choice[] همه انتخاب ها را برای یک مورد دریافت می کند.
get Feedback For Correct() Quiz Feedback بازخوردی را برمی‌گرداند که به پاسخ‌دهندگان در صورت پاسخ صحیح به یک سؤال نشان داده می‌شود.
get Feedback For Incorrect() 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 نشان داده می شود.
has Other Option() Boolean تعیین می کند که آیا مورد گزینه "دیگر" دارد یا خیر.
is Required() Boolean تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
set Choice Values(values) Multiple Choice Item انتخاب های یک مورد را از آرایه ای از رشته ها تنظیم می کند.
set Choices(choices) Multiple Choice Item مجموعه ای از گزینه ها را برای یک مورد تعیین می کند.
set Feedback For Correct(feedback) Multiple Choice Item بازخورد را تنظیم می کند تا وقتی پاسخ دهندگان به یک سؤال به درستی پاسخ دهند، به آنها نشان داده شود.
set Feedback For Incorrect(feedback) Multiple Choice Item بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤالی نادرست پاسخ می دهند، به آنها نشان داده شود.
set Help Text(text) Multiple Choice Item متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).
set Points(points) Multiple Choice Item تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند.
set Required(enabled) Multiple Choice Item تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
set Title(title) Multiple Choice Item عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).
show Other Option(enabled) Multiple Choice Item تنظیم می کند که آیا این مورد گزینه "دیگری" دارد یا خیر.

مستندات دقیق

create Choice(value)

انتخاب جدیدی ایجاد می کند.

پارامترها

نام تایپ کنید توضیحات
value String مقدار انتخاب، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می بینند

بازگشت

Choice - انتخاب جدید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

create Choice(value, isCorrect)

انتخاب جدیدی ایجاد می کند.

پارامترها

نام تایپ کنید توضیحات
value String مقدار انتخاب، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می بینند
is Correct Boolean آیا انتخاب یک پاسخ صحیح است

بازگشت

Choice - انتخاب جدید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

create Choice(value, navigationItem)

انتخاب جدیدی را با یک گزینه صفحه نانوذرات ایجاد می کند که به یک مورد صفحه شکن داده می شود. این معادل برای create Choice(value, navigationType) با navigation Type است که به Form App.PageNavigationType.GO_TO_PAGE تنظیم شده است. انتخاب هایی که از پیمایش صفحه استفاده می کنند را نمی توان در یک مورد با گزینه هایی که از پیمایش صفحه استفاده نمی کنند ترکیب کرد.

پیمایش صفحه پس از تکمیل صفحه ای که شامل این گزینه توسط مخاطب است انجام می شود و تنها در صورتی که پاسخ دهنده آن گزینه را انتخاب کرده باشد. اگر پاسخ دهنده چندین گزینه را با دستورالعمل های پیمایش صفحه در همان صفحه انتخاب کند، فقط آخرین گزینه پیمایش تأثیری دارد. پیمایش صفحه نیز در آخرین صفحه یک فرم تاثیری ندارد.

پارامترها

نام تایپ کنید توضیحات
value String مقدار انتخاب، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می بینند
navigation Item Page Break Item موردی که باید به آن پیمایش کنید

بازگشت

Choice - انتخاب جدید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

create Choice(value, navigationType)

یک انتخاب جدید با یک گزینه پیمایش صفحه ایجاد می کند. انتخاب هایی که از پیمایش صفحه استفاده می کنند را نمی توان در یک مورد با گزینه هایی که از پیمایش صفحه استفاده نمی کنند ترکیب کرد.

پیمایش صفحه پس از تکمیل صفحه ای که شامل این گزینه توسط مخاطب است انجام می شود و تنها در صورتی که پاسخ دهنده آن گزینه را انتخاب کرده باشد. اگر پاسخ دهنده چندین گزینه را با دستورالعمل های پیمایش صفحه در همان صفحه انتخاب کند، فقط آخرین گزینه پیمایش تأثیری دارد. پیمایش صفحه نیز در آخرین صفحه یک فرم تاثیری ندارد.

پارامترها

نام تایپ کنید توضیحات
value String مقدار انتخاب ، که پاسخ دهندگان هنگام مشاهده فرم به عنوان یک برچسب می بینند
navigation Type Page Navigation Type نوع ناوبری انتخاب

بازگشت

Choice - انتخاب جدید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

create Response(response)

یک Item Response جدید برای این آیتم چند گزینه ای ایجاد می کند. اگر آرگومان response با یک انتخاب معتبر برای این مورد مطابقت نداشته باشد، استثنا می‌کند، مگر اینکه show Other Option(enabled) روی true تنظیم شده باشد.

پارامترها

نام تایپ کنید توضیحات
response String یک پاسخ معتبر برای این مورد چند گزینه ای

بازگشت

Item Response - پاسخ مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.

بازگشت

Multiple Choice Item - تکراری از این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Choices()

همه گزینه ها را برای یک مورد دریافت می کند.

بازگشت

Choice[] - آرایه‌ای از انتخاب‌ها

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Feedback For Correct()

بازخوردی را برمی‌گرداند که به پاسخ‌دهندگان در صورت پاسخ صحیح به یک سؤال نشان داده می‌شود.

بازگشت

Quiz Feedback - بازخورد، در صورت وجود.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Feedback For Incorrect()

بازخوردی را برمی‌گرداند که وقتی پاسخ‌دهندگان به سؤالی نادرست پاسخ می‌دهند به آنها نشان داده می‌شود.

بازگشت

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()

نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود.

بازگشت

Item Type - نوع مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

has Other Option()

تعیین می کند که آیا مورد گزینه "دیگر" دارد یا خیر.

بازگشت

Boolean - اگر مورد گزینه "دیگر" داشته باشد true . false اگر نه

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

is Required()

تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.

بازگشت

Boolean - آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Choice Values(values)

گزینه های موردی را برای یک مورد از مجموعه ای از رشته ها تنظیم می کند. اگر آرایه داده شده خالی باشد، یک استثنا می اندازد. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

پارامترها

نام تایپ کنید توضیحات
values String[] آرایه مقادیر انتخابی، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Choices(choices)

آرایه ای از انتخاب ها را برای یک آیتم تنظیم می کند. در صورتی که آرایه داده شده خالی یا حاوی عنصر null باشد، یک استثنا پرتاب می کند. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

پارامترها

نام تایپ کنید توضیحات
choices Choice[] مجموعه ای از انتخاب ها

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

پرتاب می کند

Error - اگر آرایه داده شده null ، خالی یا حاوی عنصر null باشد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Feedback For Correct(feedback)

بازخورد را تنظیم می کند تا وقتی پاسخ دهندگان به یک سؤال به درستی پاسخ دهند، به آنها نشان داده شود. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(),
);

پارامترها

نام تایپ کنید توضیحات
feedback Quiz Feedback بازخورد جدید یک مقدار تهی بازخورد را پاک می کند.

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Feedback For Incorrect(feedback)

بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤالی نادرست پاسخ می دهند، به آنها نشان داده شود.

پارامترها

نام تایپ کنید توضیحات
feedback Quiz Feedback بازخورد جدید

بازگشت

Multiple Choice Item - این Multiple Choice 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 متن راهنما جدید

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Points(points)

تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.

پارامترها

نام تایپ کنید توضیحات
points Integer تعداد امتیاز یک مورد سوال ارزش دارد

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Required(enabled)

تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.

پارامترها

نام تایپ کنید توضیحات
enabled Boolean آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

بازگشت

Multiple Choice Item - مورد فعلی (برای زنجیر کردن)

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Title(title)

عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).

پارامترها

نام تایپ کنید توضیحات
title String عنوان یا متن سرصفحه جدید

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

show Other Option(enabled)

تنظیم می کند که آیا مورد گزینه "دیگر" داشته باشد یا خیر. پیش‌فرض برای یک Checkbox Item جدید یا Multiple Choice Item false است.

پارامترها

نام تایپ کنید توضیحات
enabled Boolean true اگر مورد گزینه "دیگر" داشته باشد. false اگر نه

بازگشت

Multiple Choice Item - این Multiple Choice Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms