Class DurationItem

DurationItem

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

// Open a form by ID and add a new duration item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDurationItem();
item.setTitle('How long can you hold your breath?');

Methods

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

פרמטרים

שםסוגתיאור
hoursIntegerהשעות, שמיוצגות כמספר שלם מ-0 עד 72
minutesIntegerהדקות, מיוצגות כמספר שלם מ-0 עד 59
secondsIntegerהשניות, שמיוצגות כמספר שלם מ-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()

הפונקציה מקבלת את סוג הפריט, שמיוצג כ-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)

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

פרמטרים

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

חזרה

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

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

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

setPoints(points)

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

פרמטרים

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

חזרה

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

אישור

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

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

setRequired(enabled)

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

פרמטרים

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

חזרה

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

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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