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

Class TimeItem

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

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

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`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