Class ScaleItem

ScaleItem

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

// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);

Methods

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

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

createResponse(response)

יצירת ItemResponse חדש לפריט הזה בסולם. גורמת להשלכת חריגה אם הארגומנט response נמצא מחוץ לגבולות שהוגדרו לפריט.

פרמטרים

שם	סוג	תיאור
response	Integer	תשובה עם ערך לפריט הזה בסולם

חזרה

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

אישור

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

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

---

duplicate()

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

חזרה

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

אישור

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

• 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

---

getLeftLabel()

הפונקציה מקבלת את התווית של הגבול התחתון של קנה המידה, אם יש כזה.

חזרה

String – התווית של הגבול התחתון של הסולם

אישור

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

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

---

getLowerBound()

הפונקציה מקבלת את הגבול התחתון של הסולם.

חזרה

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

---

getRightLabel()

הפונקציה מקבלת את התווית של הגבול העליון של קנה המידה, אם יש כזה.

חזרה

String – התווית של הגבול העליון של קנה המידה

אישור

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

• 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

---

getUpperBound()

הפונקציה מקבלת את הגבול העליון של הסולם.

חזרה

Integer – הגבול העליון של הסולם

אישור

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

• 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

---

setBounds(lower, upper)

הגדרת הגבול התחתון והעליון של הסולם. הערך של הגבול התחתון חייב להיות 0 או 1. הגבולו העליון חייב להיות בין 3 ל-10, כולל. ברירת המחדל של קנה מידה חדש היא גבול תחתון של 1 וגבול עליון של 5.

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

פרמטרים

שם	סוג	תיאור
lower	Integer	הגבול התחתון החדש
upper	Integer	הגבול העליון החדש

חזרה

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

זריקות

Error – אם הגבול התחתון או העליון לא חוקי

אישור

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

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

---

setGeneralFeedback(feedback)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setLabels(lower, upper)

הגדרת תוויות לגבול התחתון ולגבול העליון של הסולם.

פרמטרים

שם	סוג	תיאור
lower	String	התווית החדשה של הגבול התחתון
upper	String	התווית החדשה של הגבול העליון

חזרה

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

אישור

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

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

---

setPoints(points)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setRequired(enabled)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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