Class Choice

אפשרות

אפשרות בחירה אחת משויכת לסוג של Item שתומך באפשרויות כמו CheckboxItem, ListItem או MultipleChoiceItem.

// Create a new form and add a multiple-choice item.
var form = FormApp.create('Form Name');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),
        item.createChoice('Dogs', FormApp.PageNavigationType.RESTART)
    ]);

// Add another page because navigation has no effect on the last page.
form.addPageBreakItem().setTitle('You chose well!');

// Log the navigation types that each choice results in.
var choices = item.getChoices();
for (var i = 0; i < choices.length; i++) {
Logger.log('If the respondent chooses "%s", the form will %s.',
           choices[i].getValue(),
           choices[i].getPageNavigationType());
}

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
getGotoPage()	PageBreakItem	PageBreakItem מוגדר כיעד GO_TO_PAGE אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי.
getPageNavigationType()	PageNavigationType	הפונקציה מקבלת את הערך PageNavigationType שמופיע אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי.
getValue()	String	הפונקציה מקבלת את הערך של הבחירה, שאותו המשיבים רואים כתווית כשהם צופים בטופס.
isCorrectAnswer()	Boolean	הפונקציה בודקת אם הבחירה היא התשובה הנכונה לשאלה.

תיעוד מפורט

getGotoPage()

PageBreakItem מוגדר כיעד GO_TO_PAGE אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי. השיטה הזו רלוונטית רק לאפשרויות שמשויכות אל MultipleChoiceItems. לגבי אפשרויות אחרות היא מחזירה את הערך null.

החזרות

PageBreakItem – היעד GO_TO_PAGE של האפשרות הזו. אם אין אף יעד, null

הרשאות

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

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

---

getPageNavigationType()

הפונקציה מקבלת את הערך PageNavigationType שמופיע אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי. שיטה זו חלה רק על אפשרויות המשויכות אל MultipleChoiceItems. באפשרויות אחרות היא מחזירה את הערך null.

החזרות

PageNavigationType – פעולת הניווט לאפשרות הזו או null אם אין אף פעולה

הרשאות

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

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

---

getValue()

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

החזרות

String – ערך הבחירה

הרשאות

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

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

---

isCorrectAnswer()

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

החזרות

Boolean — האם הבחירה היא תשובה נכונה.

הרשאות

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

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