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

Class MultipleChoiceItem

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

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
     ])
    .showOtherOption(true);

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`createChoice(value)`	`Choice`	יצירת בחירה חדשה.
`createChoice(value, isCorrect)`	`Choice`	יצירת בחירה חדשה.
`createChoice(value, navigationItem)`	`Choice`	יוצרת בחירה חדשה עם אפשרות לניווט בדפים שקופצת לפריט נתון של מעבר דף.
`createChoice(value, navigationType)`	`Choice`	יוצר בחירה חדשה עם אפשרות לניווט בדפים.
`createResponse(response)`	`ItemResponse`	יצירת `ItemResponse` חדש עבור הפריט הזה, שהוא בחירה מרובה.
`duplicate()`	`MultipleChoiceItem`	יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס.
`getChoices()`	`Choice[]`	קבלת כל האפשרויות לפריט.
`getFeedbackForCorrect()`	`QuizFeedback`	הפונקציה מחזירה את המשוב שמוצג למשיבים כאשר הם עונים כראוי על שאלה.
`getFeedbackForIncorrect()`	`QuizFeedback`	הפונקציה מחזירה את המשוב שמוצג למשיבים כשהם משיבים באופן שגוי לשאלה.
`getHelpText()`	`String`	הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' לפריטי פריסה כמו `ImageItems`, `PageBreakItems` ו-`SectionHeaderItems`).
`getId()`	`Integer`	הפונקציה מקבלת את המזהה הייחודי של הפריט.
`getIndex()`	`Integer`	הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס.
`getPoints()`	`Integer`	מחזירה את הערך הנקודתי של פריט שניתן לתת לו ציון.
`getTitle()`	`String`	הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של `SectionHeaderItem`).
`getType()`	`ItemType`	הפונקציה מקבלת את סוג הפריט, שמיוצג כ-`ItemType`.
`hasOtherOption()`	`Boolean`	ההגדרה קובעת אם לפריט יש אפשרות 'אחר'.
`isRequired()`	`Boolean`	הגדרה זו קובעת אם המשיב חייב לענות על השאלה.
`setChoiceValues(values)`	`MultipleChoiceItem`	מגדירה את האפשרויות של פריט מתוך מערך של מחרוזות.
`setChoices(choices)`	`MultipleChoiceItem`	מגדירה מערך של אפשרויות לפריט.
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	הגדרת המשוב שיוצג למשיבים כאשר הם יענו כראוי לשאלה.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה.
`setHelpText(text)`	`MultipleChoiceItem`	מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו `ImageItems`, `PageBreakItems` ו-`SectionHeaderItems`).
`setPoints(points)`	`MultipleChoiceItem`	הגדרת מספר הנקודות לשווי של פריט שניתן לדרג.
`setRequired(enabled)`	`MultipleChoiceItem`	קובעת אם המשיב חייב לענות על השאלה.
`setTitle(title)`	`MultipleChoiceItem`	מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של `SectionHeaderItem`).
`showOtherOption(enabled)`	`MultipleChoiceItem`	ההגדרה קובעת אם לפריט יש אפשרות "אחר".

תיעוד מפורט

`createChoice(value)`

יצירת בחירה חדשה.

פרמטרים

שם	תיאור	התיאור
`value`	`String`	ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס

החזרות

Choice – האפשרות החדשה

הרשאות

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

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

`createChoice(value, isCorrect)`

יצירת בחירה חדשה.

פרמטרים

שם	תיאור	התיאור
`value`	`String`	ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס
`isCorrect`	`Boolean`	האם הבחירה היא תשובה נכונה

החזרות

Choice – האפשרות החדשה

הרשאות

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

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

`createChoice(value, navigationItem)`

יוצרת בחירה חדשה עם אפשרות לניווט בדפים שקופצת לפריט נתון של מעבר דף. הערך הזה שווה ערך לפונקציה createChoice(value, navigationType), כאשר navigationType מוגדר ל-FormApp.PageNavigationType.GO_TO_PAGE. לא ניתן לשלב באותו פריט אפשרויות שכוללות ניווט בדף, עם אפשרויות שלא משתמשות בניווט בדף.

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

פרמטרים

שם	תיאור	התיאור
`value`	`String`	ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס
`navigationItem`	`PageBreakItem`	הפריט שאליו רוצים לנווט

החזרות

Choice – האפשרות החדשה

הרשאות

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

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

`createChoice(value, navigationType)`

יוצר בחירה חדשה עם אפשרות לניווט בדפים. לא ניתן לשלב באותו פריט אפשרויות שכוללות ניווט בדף עם אפשרויות שלא משתמשות בניווט בדף.

פרמטרים

שם	תיאור	התיאור
`value`	`String`	ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס
`navigationType`	`PageNavigationType`	סוג הניווט של הבחירה

החזרות

Choice – האפשרות החדשה

הרשאות

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

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

`createResponse(response)`

יצירת ItemResponse חדש עבור הפריט הזה, שהוא בחירה מרובה. הפונקציה מוסיפה החרגה אם הארגומנט response לא תואם לבחירה תקינה עבור הפריט הזה, אלא אם הערך של showOtherOption(enabled) מוגדר ל-true.

פרמטרים

שם	תיאור	התיאור
`response`	`String`	תשובה חוקית לפריט ריבוי בחירה זה

החזרות

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

הרשאות

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

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

`duplicate()`

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

החזרות

MultipleChoiceItem – עותק משוכפל של MultipleChoiceItem, לשרשור

הרשאות

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

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

`getChoices()`

קבלת כל האפשרויות לפריט.

החזרות

Choice[] – מערך של אפשרויות

הרשאות

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

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

`getFeedbackForCorrect()`

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

החזרות

QuizFeedback – המשוב, אם יש כזה.

הרשאות

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

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

`getFeedbackForIncorrect()`

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

החזרות

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

`hasOtherOption()`

ההגדרה קובעת אם לפריט יש אפשרות 'אחר'.

החזרות

Boolean — true אם הפריט כולל את האפשרות 'אחר'; false אם לא

הרשאות

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

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

`setChoiceValues(values)`

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

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

פרמטרים

שם	תיאור	התיאור
`values`	`String[]`	מערך הערכים של הבחירה, שאותם המשיבים רואים כתוויות בעת הצגת הטופס

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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

`setChoices(choices)`

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

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

פרמטרים

שם	תיאור	התיאור
`choices`	`Choice[]`	מגוון של אפשרויות

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

קליעות

Error – אם המערך הנתון הוא null, ריק או מכיל רכיב null

הרשאות

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

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

`setFeedbackForCorrect(feedback)`

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

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

פרמטרים

שם	תיאור	התיאור
`feedback`	`QuizFeedback`	המשוב החדש. המשוב יישאר ריק.

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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

`setFeedbackForIncorrect(feedback)`

מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה.

פרמטרים

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

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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

`setHelpText(text)`

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

פרמטרים

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

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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

`setPoints(points)`

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

פרמטרים

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

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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

`setRequired(enabled)`

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

פרמטרים

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

החזרות

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

הרשאות

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

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

`setTitle(title)`

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

פרמטרים

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

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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

`showOtherOption(enabled)`

ההגדרה קובעת אם לפריט יש אפשרות "אחר". ברירת המחדל ל-CheckboxItem או ל-MultipleChoiceItem חדשים היא false.

פרמטרים

שם	תיאור	התיאור
`enabled`	`Boolean`	`true` אם לפריט יש האפשרות 'אחר', `false` אם לא

החזרות

MultipleChoiceItem — MultipleChoiceItem, לשרשור

הרשאות

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

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