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, גם השנה תתעלם.

פרמטרים

שםסוגתיאור
responseDateאובייקט 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)

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

פרמטרים

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

חזרה

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

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

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

setIncludesYear(enableYear)

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

פרמטרים

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

חזרה

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

אישור

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

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

setPoints(points)

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

פרמטרים

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

חזרה

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

אישור

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

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

setRequired(enabled)

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

פרמטרים

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

חזרה

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

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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