פריט שאלה שמאפשר למשיב לציין משך זמן. אפשר לגשת לפריטים או ליצור פריטים באמצעות Form
. כשנעשה בהם שימוש בבוחן, הפריטים האלה נותנים ציון.
// Open a form by ID and add a new duration item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
createResponse(hours, minutes, seconds) | ItemResponse | יצירת ItemResponse חדש עבור הפריט בתאריך הזה. |
duplicate() | DurationItem | יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס. |
getGeneralFeedback() | QuizFeedback | הפונקציה מחזירה את המשוב שמוצג למשיבים כשהם עונים על שאלה שניתן לתת לה ציון. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' לפריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס. |
getPoints() | Integer | מחזירה את הערך הנקודתי של פריט שניתן לתת לו ציון. |
getTitle() | String | הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType . |
isRequired() | Boolean | הגדרה זו קובעת אם המשיב חייב לענות על השאלה. |
setGeneralFeedback(feedback) | DurationItem | מגדיר את המשוב שיוצג למשיבים כשהם משיבים על שאלה שאפשר לתת לה ציון, ושאין לה תשובה נכונה או שגויה (למשל, שאלות שנדרש להן ציון ידני). |
setHelpText(text) | DurationItem | מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setPoints(points) | DurationItem | הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. |
setRequired(enabled) | DurationItem | קובעת אם המשיב חייב לענות על השאלה. |
setTitle(title) | DurationItem | מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem ). |
תיעוד מפורט
createResponse(hours, minutes, seconds)
יצירת ItemResponse
חדש עבור הפריט בתאריך הזה. הארגומנטים hours
, minutes
ו-seconds
מיוצגים באופן הטוב ביותר כמספרים שלמים מ-0
עד 72
עבור hours
ו-0
עד 59
עבור minutes
ו-seconds
. ערכים שחורגים מהגבולות האלה מוגבלים. לדוגמה, הערך 24, 60, 90
מפורש כ-24:59:59.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
hours | Integer | השעות, מיוצגות כמספר שלם בין 0 לבין 72 |
minutes | Integer | הדקות, מיוצגות כמספר שלם בין 0 לבין 59 |
seconds | Integer | השניות, מיוצגות כמספר שלם בין 0 ל-59 |
החזרות
ItemResponse
– התגובה של הפריט
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס.
החזרות
DurationItem
– עותק משוכפל של DurationItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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()
isRequired()
הגדרה זו קובעת אם המשיב חייב לענות על השאלה.
החזרות
Boolean
– האם המשיב חייב לענות על השאלה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
מגדיר את המשוב שיוצג למשיבים כשהם משיבים על שאלה שאפשר לתת לה ציון, ושאין לה תשובה נכונה או שגויה (למשל, שאלות שנדרש להן ציון ידני).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | QuizFeedback | המשוב החדש |
החזרות
DurationItem
— DurationItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
DurationItem
— DurationItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. ברירת המחדל לפריטים חדשים היא 0.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
points | Integer | את מספר הנקודות ששווה פריט שאלה מסוים |
החזרות
DurationItem
— DurationItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
DurationItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
DurationItem
— DurationItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms