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