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