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

Class RatingItem

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

روش ها

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

مستندات دقیق

`create Response(response)`

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

در صورتی که response ارائه شده کمتر از 1 یا بزرگتر از مقدار بازگردانده شده توسط get Rating Scale Level() باشد، یک استثناء اسکریپت ایجاد می کند.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

پارامترها

نام	تایپ کنید	توضیحات
`response`	`Integer`	یک پاسخ ارزشی برای این آیتم رتبه بندی.

بازگشت

Item Response - پاسخ مورد.

مجوز

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

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

`duplicate()`

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

بازگشت

Rating Item - تکراری از این Rating 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 Rating Icon()`

نماد انتخاب شده برای رتبه بندی را دریافت می کند.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

بازگشت

Rating Icon Type - نوع نماد رتبه‌بندی.

مجوز

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

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

`get Rating Scale Level()`

سطح مقیاس رتبه بندی را دریافت می کند.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

بازگشت

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`	بازخورد جدید

بازگشت

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

بازگشت

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

مجوز

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

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

`set Points(points)`

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

پارامترها

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

بازگشت

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

مجوز

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

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

`set Rating Icon(ratingIcon)`

نماد رتبه بندی را تنظیم می کند.

اگر نوع نماد رتبه‌بندی نامعتبر باشد، یک استثنای برنامه‌نویسی ایجاد می‌کند.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

پارامترها

نام	تایپ کنید	توضیحات
`rating Icon`	`Rating Icon Type`	نوع نماد رتبه بندی

بازگشت

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

پرتاب می کند

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

مجوز

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

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

`set Rating Scale Level(ratingScaleLevel)`

حداکثر سطح مقیاس رتبه بندی را تنظیم می کند. حداکثر سطح مقیاس رتبه بندی باید بین 3 تا 10 باشد. یک رتبه بندی جدید به طور پیش فرض سطح مقیاس رتبه بندی 3 است.

در صورتی که مقادیر داده شده خارج از محدودیت های مجاز باشند، یک استثناء اسکریپت ایجاد می کند.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

پارامترها

نام	تایپ کنید	توضیحات
`rating Scale Level`	`Integer`	سطح مقیاس رتبه بندی

بازگشت

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

پرتاب می کند

Error - اگر سطح مقیاس رتبه بندی نامعتبر باشد

مجوز

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

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

`set Required(enabled)`

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

پارامترها

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

بازگشت

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

مجوز

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

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

`set Title(title)`

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

پارامترها

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

بازگشت

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

مجوز

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

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