Class RatingItem

פריט הסיווג

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
createResponse(response)	ItemResponse	יוצר ItemResponse חדש לפריט הדירוג הזה.
duplicate()	RatingItem	יוצר עותק של הפריט ומצרף אותו לסוף הטופס.
getGeneralFeedback()	QuizFeedback	הפונקציה מחזירה את המשוב שמוצג למשיבים כשהם משיבים על שאלה שאפשר לתת עליה ציון.
getHelpText()	String	מקבל את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).
getId()	Integer	מחזירה את המזהה הייחודי של הפריט.
getIndex()	Integer	הפונקציה מחזירה את האינדקס של הפריט מבין כל הפריטים בטופס.
getPoints()	Integer	הפונקציה מחזירה את ערך הנקודות של פריט שאפשר לתת לו ציון.
getRatingIcon()	RatingIconType	מחזירה את הסמל שנבחר לדירוג.
getRatingScaleLevel()	Integer	מחזירה את רמת הסולם של הדירוג.
getTitle()	String	מחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).
getType()	ItemType	מחזירה את סוג הפריט, שמיוצג כ-ItemType.
isRequired()	Boolean	קובעת אם המשיב חייב לענות על השאלה.
setGeneralFeedback(feedback)	RatingItem	מגדיר את המשוב שיוצג למשיבים כשהם משיבים על שאלה שאפשר לתת עליה ציון ושאין לה תשובה נכונה או שגויה (כלומר, שאלות שצריך לתת עליהן ציון ידנית).
setHelpText(text)	RatingItem	המאפיין מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטי פריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).
setPoints(points)	RatingItem	הגדרת מספר הנקודות ששווה פריט שאפשר לתת לו ציון.
setRatingIcon(ratingIcon)	RatingItem	הגדרת הסמל של הסיווג.
setRatingScaleLevel(ratingScaleLevel)	RatingItem	הגדרת הרמה המקסימלית בסולם הדירוג.
setRequired(enabled)	RatingItem	הגדרה שקובעת אם המשיב חייב לענות על השאלה.
setTitle(title)	RatingItem	מגדיר את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).

תיעוד מפורט

createResponse(response)

יוצר ItemResponse חדש לפריט הדירוג הזה.

הפונקציה מעלה חריגה של סקריפט אם הערך שצוין response קטן מ-1 או גדול מהערך שמוחזר על ידי getRatingScaleLevel().

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

פרמטרים

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

חזרה

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

אישור

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

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

---

duplicate()

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

חזרה

‫RatingItem — עותק משוכפל של RatingItem, לשרשור

אישור

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

• 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

---

getRatingIcon()

מחזירה את הסמל שנבחר לדירוג.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

חזרה

‫RatingIconType — סוג סמל הדירוג.

אישור

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

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

---

getRatingScaleLevel()

מחזירה את רמת הסולם של הדירוג.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

חזרה

‫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	המשוב החדש

חזרה

‫RatingItem — RatingItem הזה, לשרשור

אישור

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

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

---

setHelpText(text)

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

פרמטרים

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

חזרה

‫RatingItem — RatingItem הזה, לשרשור

אישור

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

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

---

setPoints(points)

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

פרמטרים

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

חזרה

‫RatingItem — RatingItem הזה, לשרשור

אישור

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

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

---

setRatingIcon(ratingIcon)

הגדרת הסמל של הסיווג.

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

פרמטרים

שם	סוג	תיאור
ratingIcon	RatingIconType	סוג סמל הדירוג.

חזרה

‫RatingItem — ‏RatingItem, לשרשור.

זריקות

‫Error – אם סוג סמל הסיווג לא תקין

אישור

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

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

---

setRatingScaleLevel(ratingScaleLevel)

הגדרת הרמה המקסימלית בסולם הדירוג. רמת הסולם המקסימלית של הדירוג חייבת להיות בין 3 ל-10, כולל. דירוג חדש מוגדר כברירת מחדל לרמה 3 בסולם הדירוג.

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

פרמטרים

שם	סוג	תיאור
ratingScaleLevel	Integer	רמת סולם הדירוג.

חזרה

‫RatingItem — ‏RatingItem, לשרשור.

זריקות

‫Error – אם רמת סולם הדירוג לא תקינה

אישור

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

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

---

setRequired(enabled)

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

פרמטרים

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

חזרה

‫RatingItem — הפריט הנוכחי (לשרשור)

אישור

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

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

---

setTitle(title)

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

פרמטרים

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

חזרה

‫RatingItem — RatingItem הזה, לשרשור

אישור

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

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