Interface Item

مورد

یک مورد فرم عمومی که حاوی ویژگی‌های مشترک برای همه موارد است، مانند عنوان و متن راهنما. آیتم ها را می توان از یک Form مشاهده کرد یا ایجاد کرد.

برای کار بر روی ویژگی های نوع خاص، از get Type() برای بررسی Item Type آیتم مورد استفاده کنید، سپس با استفاده از روشی مانند as Checkbox Item() مورد را به کلاس مناسب ارسال کنید. 

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const textItem = item.asTextItem();
  textItem.setRequired(false);
}

اجرای کلاس ها

نام شرح مختصر

روش ها

روش نوع برگشت شرح مختصر
as Checkbox Grid Item() Checkbox Grid Item مورد را به عنوان یک مورد شبکه چک باکس برمی‌گرداند.
as Checkbox Item() Checkbox Item مورد را به عنوان یک مورد چک باکس برمی گرداند.
as Date Item() Date Item مورد را به عنوان یک مورد تاریخ برمی گرداند.
as Date Time Item() Date Time Item مورد را به عنوان یک مورد تاریخ-زمان برمی‌گرداند.
as Duration Item() Duration Item مورد را به عنوان یک مورد مدت زمان برمی‌گرداند.
as Grid Item() Grid Item مورد را به عنوان یک مورد شبکه برمی گرداند.
as Image Item() Image Item مورد را به عنوان یک آیتم تصویر برمی گرداند.
as List Item() List Item مورد را به عنوان یک مورد لیست برمی گرداند.
as Multiple Choice Item() Multiple Choice Item مورد را به عنوان یک مورد چندگزینه ای برمی گرداند.
as Page Break Item() Page Break Item مورد را به عنوان یک مورد شکستگی صفحه برمی گرداند.
as Paragraph Text Item() Paragraph Text Item مورد را به عنوان یک پاراگراف-متن مورد برمی‌گرداند.
as Rating Item() Rating Item مورد را به عنوان یک مورد رتبه بندی برمی گرداند.
as Scale Item() Scale Item مورد را به عنوان یک مورد مقیاس برمی گرداند.
as Section Header Item() Section Header Item مورد را به عنوان یک مورد سرفصل بخش برمی‌گرداند.
as Text Item() Text Item مورد را به عنوان یک مورد متنی برمی گرداند.
as Time Item() Time Item مورد را به عنوان یک آیتم زمان برمی گرداند.
as Video Item() Video Item مورد را به عنوان یک مورد ویدیویی برمی گرداند.
duplicate() Item یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
get Help Text() String متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items نامیده می‌شود).
get Id() Integer شناسه منحصر به فرد مورد را دریافت می کند.
get Index() Integer نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.
get Title() String عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item ).
get Type() Item Type نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود.
set Help Text(text) Item متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).
set Title(title) Item عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).

مستندات دقیق

as Checkbox Grid Item()

مورد را به عنوان یک مورد شبکه چک باکس برمی‌گرداند. در صورتی که Item Type قبلاً CHECKBOX_GRID نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Checkbox Grid Item - آیتم شبکه چک باکس

پرتاب می کند

Error - اگر مورد یک مورد شبکه چک باکس نباشد

مجوز

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

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

as Checkbox Item()

مورد را به عنوان یک مورد چک باکس برمی گرداند. در صورتی که Item Type قبلاً CHECKBOX نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Checkbox Item - مورد چک باکس

پرتاب می کند

Error - اگر مورد یک مورد چک باکس نباشد

مجوز

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

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

as Date Item()

مورد را به عنوان یک مورد تاریخ برمی گرداند. در صورتی که Item Type قبلاً DATE نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Date Item - مورد تاریخ

پرتاب می کند

Error - اگر مورد مورد تاریخ نباشد

مجوز

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

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

as Date Time Item()

مورد را به عنوان یک مورد تاریخ-زمان برمی‌گرداند. در صورتی که Item Type قبلاً DATETIME نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Date Time Item - مورد تاریخ-زمان

پرتاب می کند

Error - اگر مورد یک مورد تاریخ-زمان نباشد

مجوز

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

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

as Duration Item()

مورد را به عنوان یک مورد مدت زمان برمی‌گرداند. اگر Item Type قبلاً DURATION نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Duration Item - مورد مدت

پرتاب می کند

Error - اگر مورد مورد مدت زمان نباشد

مجوز

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

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

as Grid Item()

مورد را به عنوان یک مورد شبکه برمی گرداند. در صورتی که Item Type قبلاً GRID نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Grid Item - مورد شبکه

پرتاب می کند

Error - اگر مورد یک مورد شبکه نیست

مجوز

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

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

as Image Item()

مورد را به عنوان یک آیتم تصویر برمی گرداند. در صورتی که Item Type قبلاً IMAGE نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Image Item - آیتم تصویر

پرتاب می کند

Error - اگر مورد یک آیتم تصویری نباشد

as List Item()

مورد را به عنوان یک مورد لیست برمی گرداند. در صورتی که Item Type قبلاً LIST نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

List Item - مورد فهرست

پرتاب می کند

Error - اگر مورد یک مورد فهرست نباشد

مجوز

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

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

as Multiple Choice Item()

مورد را به عنوان یک مورد چندگزینه ای برمی گرداند. اگر Item Type قبلاً MULTIPLE_CHOICE نبوده است، یک استثنای اسکریپت ایجاد می‌کند.

بازگشت

Multiple Choice Item - مورد چند گزینه ای

پرتاب می کند

Error - اگر مورد یک مورد چند گزینه ای نباشد

مجوز

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

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

as Page Break Item()

مورد را به عنوان یک مورد شکستگی صفحه برمی گرداند. در صورتی که Item Type قبلاً PAGE_BREAK نبوده است، یک استثنای اسکریپت ایجاد می‌کند.

بازگشت

Page Break Item - مورد شکستن صفحه

پرتاب می کند

Error - اگر مورد مورد شکست صفحه نباشد

مجوز

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

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

as Paragraph Text Item()

مورد را به عنوان یک پاراگراف-متن مورد برمی‌گرداند. در صورتی که Item Type قبلاً PARAGRAPH_TEXT نبوده است، یک استثنای اسکریپت ایجاد می کند.

بازگشت

Paragraph Text Item - مورد متن پاراگراف

پرتاب می کند

Error - اگر مورد یک مورد متنی پاراگراف نباشد

مجوز

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

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

as Rating Item()

مورد را به عنوان یک مورد رتبه بندی برمی گرداند. در صورتی که Item Type قبلا RATING نبوده است، یک ScriptingException پرتاب می کند. 

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

بازگشت

Rating Item - آیتم رتبه بندی.

پرتاب می کند

Error - اگر مورد یک مورد رتبه بندی نباشد

مجوز

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

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

as Scale Item()

مورد را به عنوان یک مورد مقیاس برمی گرداند. در صورتی که Item Type قبلاً SCALE نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Scale Item - مورد مقیاس

پرتاب می کند

Error - اگر مورد یک مورد مقیاس نباشد

مجوز

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

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

as Section Header Item()

مورد را به عنوان یک مورد سرفصل بخش برمی‌گرداند. در صورتی که Item Type قبلاً SECTION_HEADER نبوده است، یک استثناء اسکریپت ایجاد می‌کند.

بازگشت

Section Header Item - مورد سرصفحه بخش

پرتاب می کند

Error - اگر مورد یک مورد سرصفحه بخش نباشد

مجوز

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

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

as Text Item()

مورد را به عنوان یک مورد متنی برمی گرداند. در صورتی که Item Type قبلا TEXT نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Text Item - مورد متنی

پرتاب می کند

Error - اگر مورد یک مورد متنی نباشد

مجوز

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

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

as Time Item()

مورد را به عنوان یک آیتم زمان برمی گرداند. در صورتی که Item Type قبلاً TIME نبوده است، یک استثناء اسکریپت ایجاد می کند.

بازگشت

Time Item - آیتم زمان

پرتاب می کند

Error - اگر مورد مورد زمان نباشد

مجوز

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

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

as Video Item()

مورد را به عنوان یک مورد ویدیویی برمی گرداند. در صورتی که Item Type قبلا VIDEO نبوده است، یک استثنای اسکریپت ایجاد می کند.

بازگشت

Video Item - مورد ویدیویی

پرتاب می کند

Error - اگر مورد یک مورد ویدیویی نباشد

duplicate()

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

بازگشت

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

مجوز

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

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

set Help Text(text)

متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).

پارامترها

نام تایپ کنید توضیحات
text String متن راهنما جدید

بازگشت

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

مجوز

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

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

set Title(title)

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

پارامترها

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

بازگشت

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

مجوز

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

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