Class TextItem

مورد متنی

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

// Open a form by ID and add a new text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addTextItem();
item.setTitle('What is your name?');

روش ها

روش نوع برگشت شرح مختصر
clear Validation() Text Item هر گونه اعتبارسنجی داده را برای این مورد متنی حذف می کند.
create Response(response) Item Response یک Item Response جدید برای این آیتم متنی ایجاد می کند.
duplicate() Text Item یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
get General Feedback() 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 نشان داده می شود.
is Required() Boolean تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
set General Feedback(feedback) Text Item بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.
set Help Text(text) Text Item متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).
set Points(points) Text Item تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند.
set Required(enabled) Text Item تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
set Title(title) Text Item عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).
set Validation(validation) Text Item اعتبار سنجی داده را برای این مورد متنی تنظیم می کند.

مستندات دقیق

clear Validation()

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

بازگشت

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

مجوز

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

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

create Response(response)

یک Item Response جدید برای این آیتم متنی ایجاد می کند.

پارامترها

نام تایپ کنید توضیحات
response String پاسخ به سوال مطرح شده توسط آیتم

بازگشت

Item Response - پاسخ مورد

مجوز

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

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

duplicate()

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

بازگشت

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

مجوز

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

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

get General Feedback()

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

بازگشت

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

is Required()

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

بازگشت

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

مجوز

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

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

set General Feedback(feedback)

بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.

پارامترها

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

بازگشت

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

بازگشت

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

مجوز

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

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

set Points(points)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Required(enabled)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Title(title)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Validation(validation)

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

پارامترها

نام تایپ کنید توضیحات
validation Text Validation یک TextValidation برای اعمال به این مورد.

بازگشت

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

مجوز

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

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