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?');

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
createResponse(response)	ItemResponse	יצירת ItemResponse חדש לפריט התאריך-שעה הזה.
duplicate()	DateTimeItem	יצירת עותק של הפריט הזה והוספתו לסוף הטופס.
getGeneralFeedback()	QuizFeedback	הפונקציה מחזירה את המשוב שמוצג לתלמידים כשהם משיבים לשאלה שניתנת למתן ציונים.
getHelpText()	String	הפונקציה מקבלת את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו ImageItems,‏ PageBreakItems ו-SectionHeaderItems).
getId()	Integer	הפונקציה מקבלת את המזהה הייחודי של הפריט.
getIndex()	Integer	הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס.
getPoints()	Integer	הפונקציה מחזירה את ערך הנקודות של פריט שאפשר לתת עליו ציון.
getTitle()	String	הפונקציה מקבלת את שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem).
getType()	ItemType	הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType.
includesYear()	Boolean	קובע אם פריט התאריך כולל אפשרות לשנה.
isRequired()	Boolean	קובע אם המשיב חייב לענות על השאלה.
setGeneralFeedback(feedback)	DateTimeItem	מגדיר את המשוב שיוצג למשתתפים כשהם משיבים לשאלה שניתנת למתן ציונים, שאין לה תשובה נכונה או שגויה (כלומר, שאינה ניתנת למתן ציונים אוטומטי).
setHelpText(text)	DateTimeItem	מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו ImageItems,‏ PageBreakItems ו-SectionHeaderItems).
setIncludesYear(enableYear)	DateTimeItem	מגדיר אם פריט התאריך כולל הגדרת שנה.
setPoints(points)	DateTimeItem	הגדרת מספר הנקודות שפריט שניתן להגיש עליו מטלה שווה.
setRequired(enabled)	DateTimeItem	מגדיר אם המשיב חייב לענות על השאלה.
setTitle(title)	DateTimeItem	הגדרת שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem).

מסמכים מפורטים

createResponse(response)

יצירת ItemResponse חדש לפריט התאריך-שעה הזה. המערכת מתעלמת משדה השניות של האובייקט Date. כברירת מחדל, המערכת משתמשת בשדות השנה, החודש, היום, השעה והדקה. אם הערך של setIncludesYear(enabled) מוגדר כ-false, גם השנה תתעלם.

פרמטרים

שם	סוג	תיאור
response	Date	אובייקט Date שמייצג חודש, יום, שעה, דקה ואולי גם שנה

חזרה

ItemResponse – התגובה של הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

duplicate()

יצירת עותק של הפריט הזה והוספתו לסוף הטופס.

חזרה

DateTimeItem – עותק כפול של DateTimeItem הזה, לצורך שרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getGeneralFeedback()

הפונקציה מחזירה את המשוב שמוצג לתלמידים כשהם משיבים לשאלה שניתנת למתן ציונים.

חזרה

QuizFeedback – המשוב, אם יש כזה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• 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

---

getPoints()

הפונקציה מחזירה את ערך הנקודות של פריט שאפשר לתת עליו ציון.

חזרה

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

---

includesYear()

קובע אם פריט התאריך כולל אפשרות לשנה.

חזרה

Boolean — true אם התאריך כולל הגדרת שנה, false אם לא

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

isRequired()

קובע אם המשיב חייב לענות על השאלה.

חזרה

Boolean – אם המשיב חייב להשיב על השאלה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setGeneralFeedback(feedback)

מגדיר את המשוב שיוצג למשתתפים כשהם משיבים לשאלה שניתנת למתן ציונים, שאין לה תשובה נכונה או שגויה (כלומר, שאינה ניתנת למתן ציונים אוטומטי).

פרמטרים

שם	סוג	תיאור
feedback	QuizFeedback	המשוב החדש

חזרה

DateTimeItem — ה-DateTimeItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setHelpText(text)

מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו ImageItems,‏ PageBreakItems ו-SectionHeaderItems).

פרמטרים

שם	סוג	תיאור
text	String	טקסט העזרה החדש

חזרה

DateTimeItem — ה-DateTimeItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setIncludesYear(enableYear)

מגדיר אם פריט התאריך כולל הגדרת שנה. ערך ברירת המחדל לפריטי תאריך חדשים הוא true.

פרמטרים

שם	סוג	תיאור
enableYear	Boolean	true אם התאריך כולל הגדרת שנה, false אם לא

חזרה

DateTimeItem — ה-DateTimeItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setPoints(points)

הגדרת מספר הנקודות שפריט שניתן להגיש עליו מטלה שווה. ערך ברירת המחדל לפריטים חדשים הוא 0.

פרמטרים

שם	סוג	תיאור
points	Integer	מספר הנקודות שמשויכות לפריט השאלה

חזרה

DateTimeItem — ה-DateTimeItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setRequired(enabled)

מגדיר אם המשיב חייב לענות על השאלה.

פרמטרים

שם	סוג	תיאור
enabled	Boolean	אם המשיב חייב להשיב על השאלה

חזרה

DateTimeItem – הפריט הנוכחי (לשרשור)

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setTitle(title)

הגדרת שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem).

פרמטרים

שם	סוג	תיאור
title	String	הטקסט החדש של הכותרת או הכותרת הראשית

חזרה

DateTimeItem — ה-DateTimeItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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