דף זה תורגם על ידי Cloud Translation API.

Class ScaleItem

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

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

שיטות

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