אפשרות בחירה אחת משויכת לסוג של 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
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