Class MultipleChoiceItem

MultipleChoiceItem

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

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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	המשוב החדש. ערך null ימחק את המשוב.

חזרה

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