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|nullמחזירה את המשוב שמוצג למשיבים כשהם עונים נכון על שאלה.
getFeedbackForIncorrect()QuizFeedback|nullמחזירה את המשוב שמוצג למשיבים כשהם עונים על שאלה בצורה לא נכונה.
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)

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

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס

חזרה

Choice – הבחירה החדשה

אישור

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

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

createChoice(value, isCorrect)

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

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס
isCorrectBooleanאם הבחירה היא תשובה נכונה

חזרה

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. אי אפשר לשלב באותו פריט בחירות שמשתמשות בניווט בין דפים עם בחירות שלא משתמשות בניווט בין דפים.

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

שימו לב: כשמשתמשים בניווט בדף של פריט, הניתוב מוטמע בקוד, ולכן לא מומלץ להשתמש ב-showOtherOption(true) במקביל.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס
navigationItemPageBreakItemהפריט שאליו רוצים לנווט

חזרה

Choice – הבחירה החדשה

אישור

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

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

createChoice(value, navigationType)

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

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

שימו לב: כשמשתמשים בניווט בדף של פריט, הניתוב מוטמע בקוד, ולכן לא מומלץ להשתמש ב-showOtherOption(true) במקביל.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס
navigationTypePageNavigationTypeסוג הניווט של הבחירה

חזרה

Choice – הבחירה החדשה

אישור

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

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

createResponse(response)

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

פרמטרים

שםסוגתיאור
responseStringתשובה תקפה לפריט הזה של בחירה מרובה

חזרה

‫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|null – המשוב, אם יש כזה.

אישור

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

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

getFeedbackForIncorrect()

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

חזרה

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

אישור

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

  • 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']);

פרמטרים

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

חזרה

‫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')]);

פרמטרים

שםסוגתיאור
choicesChoice[]מערך של אפשרויות

חזרה

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

מקפיצה את הודעות השגיאה (Throws)

‫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().setText('Dogs rule, cats drool.').build(),
);

פרמטרים

שםסוגתיאור
feedbackQuizFeedbackהמשוב החדש. ערך null ינקה את המשוב.

חזרה

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

אישור

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

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

setFeedbackForIncorrect(feedback)

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

פרמטרים

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

חזרה

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

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

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

setPoints(points)

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

פרמטרים

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

חזרה

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

אישור

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

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

setRequired(enabled)

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

פרמטרים

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

חזרה

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

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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

showOtherOption(enabled)

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

פרמטרים

שםסוגתיאור
enabledBoolean‫true אם יש לפריט אפשרות 'אחר'; false אם לא

חזרה

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

אישור

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

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