Class DateItem

تاریخ مورد

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

// Open a form by ID and add a new date item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateItem();
item.setTitle('When were you born?');

روش‌ها

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

مستندات دقیق

create Response(response)

یک Item Response جدید برای این آیتم تاریخ ایجاد می‌کند. فیلدهای زمان شیء Date نادیده گرفته می‌شوند؛ به طور پیش‌فرض، فقط فیلدهای سال، ماه و روز استفاده می‌شوند. اگر set Includes Year(enabled) روی false تنظیم شده باشد، سال نیز نادیده گرفته می‌شود.

پارامترها

نام نوع توضیحات
response Date یک شیء Date که نشان دهنده یک ماه، روز و احتمالاً سال است

بازگشت

Item Response — پاسخ مورد

مجوز

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

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

duplicate()

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

بازگشت

Date Item - یک کپی از این Date Item ، برای زنجیره‌سازی

مجوز

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

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

get General Feedback()

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

بازگشت

Quiz Feedback |null — بازخورد، در صورت وجود.

مجوز

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

  • 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

includes Year()

تعیین می‌کند که آیا آیتم تاریخ شامل گزینه سال می‌شود یا خیر.

بازگشت

Boolean - اگر تاریخ شامل تنظیم سال باشد، true و در غیر این صورت، false .

مجوز

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

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

بازگشت

Date Item — این Date 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 متن کمک جدید

بازگشت

Date Item — این Date Item ، برای زنجیره‌سازی

مجوز

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

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

set Includes Year(enableYear)

تعیین می‌کند که آیا آیتم تاریخ شامل تنظیم سال باشد یا خیر. مقدار پیش‌فرض برای آیتم‌های تاریخ جدید true است.

پارامترها

نام نوع توضیحات
enable Year Boolean اگر تاریخ شامل تنظیم سال باشد، true و در غیر این صورت، false .

بازگشت

Date Item — این Date Item ، برای زنجیره‌سازی

مجوز

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

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

set Points(points)

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

پارامترها

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

بازگشت

Date Item — این Date Item ، برای زنجیره‌سازی

مجوز

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

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

set Required(enabled)

مشخص می‌کند که آیا پاسخ‌دهنده باید به سوال پاسخ دهد یا خیر.

پارامترها

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

بازگشت

Date Item — آیتم فعلی (برای زنجیره‌سازی)

مجوز

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

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

set Title(title)

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

پارامترها

نام نوع توضیحات
title String عنوان یا متن سربرگ جدید

بازگشت

Date Item — این Date Item ، برای زنجیره‌سازی

مجوز

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

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