Class CheckboxItem

مورد انتخاب‌شده

یک آیتم سوالی که به پاسخ‌دهنده اجازه می‌دهد یک یا چند کادر انتخاب و همچنین یک فیلد اختیاری "سایر" را انتخاب کند. آیتم‌ها را می‌توان از طریق یک 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 تعیین می‌کند که آیا آیتم گزینه "سایر" را داشته باشد یا خیر.

مستندات دقیق

clear Validation()

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

بازگشت

Checkbox Item — این Checkbox Item ، برای زنجیره‌سازی

مجوز

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

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

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

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

پارامترها

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

بازگشت

Item Response — پاسخ مورد

مجوز

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

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

duplicate()

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

بازگشت

Checkbox Item — یک کپی از این Checkbox 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 |null — بازخورد، در صورت وجود.

مجوز

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

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

get Feedback For Incorrect()

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

بازگشت

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

مجوز

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

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

بازگشت

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

بازگشت

Checkbox Item — این Checkbox 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 بازخورد جدید. مقدار تهی، بازخورد را پاک می‌کند.

بازگشت

Checkbox Item — این Checkbox Item ، برای زنجیره‌سازی

مجوز

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

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

set Feedback For Incorrect(feedback)

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

پارامترها

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

بازگشت

Checkbox Item — این Checkbox 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 متن کمک جدید

بازگشت

Checkbox Item — این Checkbox Item ، برای زنجیره‌سازی

مجوز

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

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

set Points(points)

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

پارامترها

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

بازگشت

Checkbox Item — این Checkbox Item ، برای زنجیره‌سازی

مجوز

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

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

set Required(enabled)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Title(title)

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

پارامترها

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

بازگشت

Checkbox Item — این Checkbox Item ، برای زنجیره‌سازی

مجوز

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

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

set Validation(validation)

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

پارامترها

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

بازگشت

Checkbox Item — این Checkbox 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 .

بازگشت

Checkbox Item — این Checkbox Item ، برای زنجیره‌سازی

مجوز

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

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