Class DateTimeItem

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

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

// Open a form by ID and add a new date-time item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');

روش‌ها

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

مجوز

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

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

set Points(points)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Required(enabled)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Title(title)

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

پارامترها

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

بازگشت

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

مجوز

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

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