דף זה תורגם על ידי 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