דף זה תורגם על ידי Cloud Translation API.

Class TimeItem

פריט שאלה שמאפשר למשתמש לציין שעה ביום. אפשר לגשת לפריטים או ליצור אותם מ-Form. כשמשתמשים בפריטים כאלה במבחן, הם מקבלים ציונים.

// Open a form by ID and add a new time item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addTimeItem();
item.setTitle('What time do you usually wake up in the morning?');

Methods

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

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

`createResponse(hour, minute)`

יצירת ItemResponse חדש לפריט הזמן הזה. מומלץ לייצג את הארגומנטים hour ו-minute כמספרים שלמים מ-0 עד 23 ומ-0 עד 59, בהתאמה. אם הם חורגים מהגבולות האלה, הם מתנהגים כמו שעון: לדוגמה, הערך 10, 90 מפורש כ-11:30 והערך -1, 60 מפורש כ-00:00.

פרמטרים

שם	סוג	תיאור
`hour`	`Integer`	השעה, מיוצגת כמספר שלם בין `0` ל-`23`
`minute`	`Integer`	הדקה בשעה, מיוצגת כמספר שלם מ-`0` עד `59`

חזרה

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

אישור

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

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

`duplicate()`

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

חזרה

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

אישור

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

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

`isRequired()`

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

חזרה

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

אישור

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

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

`setGeneralFeedback(feedback)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setHelpText(text)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setPoints(points)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setRequired(enabled)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setTitle(title)`

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

פרמטרים

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

חזרה

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

אישור

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

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