Class MultipleChoiceItem

MultipleChoiceItem

פריט שאלה שמאפשר למשיבים לבחור אפשרות אחת מתוך רשימה של לחצני בחירה או אפשרות 'אחר' השדה הזה. ניתן לגשת לפריטים או ליצור אותם מ-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)

יצירת אפשרות חדשה.

פרמטרים

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

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

פרמטרים

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

חזרה

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

אישור

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

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

createChoice(value, navigationType)

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

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

פרמטרים

שםסוגתיאור
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 – המשוב, אם יש כזה.

אישור

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

  • 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 אם לפריט יש 'אחר' Option; 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']);

פרמטרים

שםסוגתיאור
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.
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')
]);

פרמטרים

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

חזרה

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());

פרמטרים

שםסוגתיאור
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.

פרמטרים

שםסוגתיאור
enabledBooleantrue אם לפריט יש 'אחר' Option; false אם לא

חזרה

MultipleChoiceItem – הMultipleChoiceItem הזה, לשרשור

אישור

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

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