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

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