این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Interface Item

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

برای کار بر روی خصوصیات نوع خاص، getType() برای بررسی ItemType مورد استفاده کنید، سپس با استفاده از روشی مانند asCheckboxItem() مورد را به کلاس مناسب ارسال کنید.

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

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

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

اجرای کلاس ها

نام	توضیح مختصر

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
`asCheckboxGridItem()`	`CheckboxGridItem`	مورد را به عنوان یک مورد شبکه چک باکس برمی‌گرداند.
`asCheckboxItem()`	`CheckboxItem`	مورد را به عنوان یک مورد چک باکس برمی گرداند.
`asDateItem()`	`DateItem`	مورد را به عنوان یک مورد تاریخ برمی گرداند.
`asDateTimeItem()`	`DateTimeItem`	مورد را به عنوان یک مورد تاریخ-زمان برمی‌گرداند.
`asDurationItem()`	`DurationItem`	مورد را به عنوان یک مورد مدت زمان برمی‌گرداند.
`asGridItem()`	`GridItem`	مورد را به عنوان یک مورد شبکه برمی گرداند.
`asImageItem()`	`ImageItem`	مورد را به عنوان یک آیتم تصویر برمی گرداند.
`asListItem()`	`ListItem`	مورد را به عنوان یک مورد لیست برمی گرداند.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	مورد را به عنوان یک مورد چندگزینه ای برمی گرداند.
`asPageBreakItem()`	`PageBreakItem`	مورد را به عنوان یک مورد شکستگی صفحه برمی گرداند.
`asParagraphTextItem()`	`ParagraphTextItem`	مورد را به عنوان یک پاراگراف-متن مورد برمی‌گرداند.
`asScaleItem()`	`ScaleItem`	مورد را به عنوان یک مورد مقیاس برمی گرداند.
`asSectionHeaderItem()`	`SectionHeaderItem`	مورد را به عنوان یک مورد سرفصل بخش برمی‌گرداند.
`asTextItem()`	`TextItem`	مورد را به عنوان یک مورد متنی برمی گرداند.
`asTimeItem()`	`TimeItem`	مورد را به عنوان یک آیتم زمان برمی گرداند.
`asVideoItem()`	`VideoItem`	مورد را به عنوان یک مورد ویدیویی برمی گرداند.
`duplicate()`	`Item`	یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
`getHelpText()`	`String`	متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند `ImageItems` ، `PageBreakItems` و `SectionHeaderItems` نامیده می‌شود).
`getId()`	`Integer`	شناسه منحصر به فرد مورد را دریافت می کند.
`getIndex()`	`Integer`	نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.
`getTitle()`	`String`	عنوان مورد را دریافت می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد `SectionHeaderItem` ).
`getType()`	`ItemType`	نوع مورد را دریافت می کند که به صورت `ItemType` نمایش داده می شود.
`setHelpText(text)`	`Item`	متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند `ImageItems` ، `PageBreakItems` و `SectionHeaderItems` نامیده می‌شود).
`setTitle(title)`	`Item`	عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد `SectionHeaderItem` ).

مستندات دقیق

`asCheckboxGridItem()`

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

برگشت

CheckboxGridItem - مورد شبکه چک باکس

پرتاب می کند

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

مجوز

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

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

`asCheckboxItem()`

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

برگشت

CheckboxItem - مورد چک باکس

پرتاب می کند

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

مجوز

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

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

`asDateItem()`

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

برگشت

DateItem - مورد تاریخ

پرتاب می کند

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

مجوز

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

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

`asDateTimeItem()`

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

برگشت

DateTimeItem - مورد تاریخ-زمان

پرتاب می کند

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

مجوز

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

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

`asDurationItem()`

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

برگشت

DurationItem - مورد مدت

پرتاب می کند

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

مجوز

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

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

`asGridItem()`

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

برگشت

GridItem - مورد شبکه

پرتاب می کند

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

مجوز

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

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

`asImageItem()`

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

برگشت

ImageItem - مورد تصویر

پرتاب می کند

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

`asListItem()`

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

برگشت

ListItem - مورد فهرست

پرتاب می کند

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

مجوز

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

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

`asMultipleChoiceItem()`

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

برگشت

MultipleChoiceItem - مورد چند گزینه ای

پرتاب می کند

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

مجوز

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

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

`asPageBreakItem()`

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

برگشت

PageBreakItem - مورد شکستن صفحه

پرتاب می کند

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

مجوز

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

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

`asParagraphTextItem()`

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

برگشت

ParagraphTextItem - مورد پاراگراف-متن

پرتاب می کند

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

مجوز

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

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

`asScaleItem()`

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

برگشت

ScaleItem - مورد مقیاس

پرتاب می کند

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

مجوز

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

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

`asSectionHeaderItem()`

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

برگشت

SectionHeaderItem - مورد سرفصل بخش

پرتاب می کند

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

مجوز

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

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

`asTextItem()`

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

برگشت

TextItem - مورد متنی

پرتاب می کند

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

مجوز

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

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

`asTimeItem()`

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

برگشت

TimeItem - آیتم زمان

پرتاب می کند

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

مجوز

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

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

`asVideoItem()`

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

برگشت

VideoItem - مورد ویدیویی

پرتاب می کند

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

`duplicate()`

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

برگشت

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

مجوز

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

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

`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

`setHelpText(text)`

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

مولفه های

نام	تایپ کنید	شرح
`text`	`String`	متن راهنما جدید

برگشت

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

مجوز

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

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

`setTitle(title)`

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

مولفه های

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

برگشت

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

مجوز

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

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