Class CheckboxItem

مورد انتخاب

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

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

روش‌ها

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

مستندات دقیق

clearValidation()

هرگونه اعتبارسنجی داده را برای این مورد از کادر انتخاب حذف می‌کند.

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

createChoice(value)

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

پارامترها

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

بازگشت

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

مجوز

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

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

createChoice(value, isCorrect)

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

پارامترها

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

بازگشت

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

مجوز

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

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

createResponse(responses)

یک ItemResponse جدید برای این آیتم چک‌باکس ایجاد می‌کند. آرگومان responses یک آرایه String[] است که حاوی مقادیری است که باید بررسی شوند. اگر هر مقداری با انتخاب معتبر برای این آیتم مطابقت نداشته باشد، استثنا ایجاد می‌کند، مگر اینکه showOtherOption(enabled) روی true تنظیم شده باشد.

پارامترها

نام نوع توضیحات
responses String[] مجموعه‌ای از پاسخ‌های معتبر برای این سوال چندگزینه‌ای

بازگشت

ItemResponse — پاسخ آیتم

مجوز

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

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

duplicate()

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

بازگشت

CheckboxItem — یک کپی از این CheckboxItem ، برای زنجیره‌سازی

مجوز

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

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

getChoices()

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

بازگشت

Choice[] — مجموعه‌ای از انتخاب‌ها

مجوز

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

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

getFeedbackForCorrect()

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

بازگشت

QuizFeedback |null — بازخورد، در صورت وجود.

مجوز

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

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

getFeedbackForIncorrect()

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

بازگشت

QuizFeedback |null — بازخورد، در صورت وجود.

مجوز

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

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

نوع آیتم را که به صورت ItemType نمایش داده می‌شود، دریافت می‌کند.

بازگشت

ItemType — نوع آیتم

مجوز

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

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

hasOtherOption()

مشخص می‌کند که آیا آیتم گزینه‌ی «سایر» دارد یا خیر.

بازگشت

Boolean - اگر آیتم گزینه "دیگری" داشته باشد، true و در غیر این صورت false برمی‌گرداند.

مجوز

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

  • 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

setChoiceValues(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[] آرایه‌ای از مقادیر انتخابی، که پاسخ‌دهندگان هنگام مشاهده فرم به عنوان برچسب می‌بینند

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

setChoices(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[] مجموعه‌ای از انتخاب‌ها

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

پرتاب‌ها

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

مجوز

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

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

setFeedbackForCorrect(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().setText('Dogs rule, cats drool.').build(),
);

پارامترها

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

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

setFeedbackForIncorrect(feedback)

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

پارامترها

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

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

setHelpText(text)

متن راهنمای آیتم را تنظیم می‌کند (گاهی اوقات برای آیتم‌های طرح‌بندی مانند ImageItems ، PageBreakItems و SectionHeaderItems ، متن توضیحات نامیده می‌شود).

پارامترها

نام نوع توضیحات
text String متن کمک جدید

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

setPoints(points)

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

پارامترها

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

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

setRequired(enabled)

مشخص می‌کند که آیا پاسخ‌دهنده باید به سوال پاسخ دهد یا خیر.

پارامترها

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

بازگشت

CheckboxItem — آیتم فعلی (برای زنجیره‌سازی)

مجوز

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

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

setTitle(title)

عنوان آیتم را تنظیم می‌کند (که گاهی اوقات در مورد SectionHeaderItem ، متن سربرگ نامیده می‌شود).

پارامترها

نام نوع توضیحات
title String عنوان یا متن سربرگ جدید

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

setValidation(validation)

اعتبارسنجی داده‌ها را برای این مورد چک‌باکس تنظیم می‌کند. ارسال مقدار null یا اعتبارسنجی بدون فراخوانی هیچ تابع require، هرگونه اعتبارسنجی قبلی را حذف می‌کند.

پارامترها

نام نوع توضیحات
validation Checkbox Validation یک CheckboxValidation برای اعمال روی این مورد.

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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

showOtherOption(enabled)

تنظیم می‌کند که آیا آیتم گزینه "other" دارد یا خیر. مقدار پیش‌فرض برای CheckboxItem یا MultipleChoiceItem جدید false است.

پارامترها

نام نوع توضیحات
enabled Boolean اگر مورد گزینه "سایر" داشته باشد، true و در غیر این صورت، false .

بازگشت

CheckboxItem — این CheckboxItem برای زنجیره‌سازی

مجوز

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

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