פריט שאלה שמאפשר למשיב לבחור אפשרות אחת מתוך רשימת לחצני בחירה או שדה אופציונלי מסוג "other". אפשר לגשת לפריטים או ליצור אותם דרך 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)
createChoice(value, isCorrect)
יצירת בחירה חדשה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
value | String | ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס |
isCorrect | Boolean | האם הבחירה היא תשובה נכונה |
החזרות
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
. לא ניתן לשלב באותו פריט אפשרויות שכוללות ניווט
בדף, עם אפשרויות שלא משתמשות בניווט בדף.
הניווט בדף מתבצע אחרי שהמשיב משלים דף שמכיל את האפשרות, ורק אם המשיב בחר באפשרות הזו. אם המשיב בחר מספר אפשרויות עם הוראות לניווט בדף באותו הדף, רק לאפשרות הניווט האחרונה תהיה השפעה. לניווט בדפים אין השפעה גם על הדף האחרון בטופס.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
value | String | ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס |
navigationItem | PageBreakItem | הפריט שאליו רוצים לנווט |
החזרות
Choice
– האפשרות החדשה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
יצירת ItemResponse
חדש עבור הפריט הזה, שהוא בחירה מרובה. הפונקציה מוסיפה החרגה אם
הארגומנט response
לא תואם לבחירה תקינה עבור הפריט הזה, אלא אם הערך של showOtherOption(enabled)
מוגדר ל-true
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
response | String | תשובה חוקית לפריט ריבוי בחירה זה |
החזרות
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()
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()
hasOtherOption()
ההגדרה קובעת אם לפריט יש אפשרות 'אחר'.
החזרות
Boolean
— true
אם הפריט כולל את האפשרות 'אחר'; 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']);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
values | String[] | מערך הערכים של הבחירה, שאותם המשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
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') ]);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
choices | Choice[] | מגוון של אפשרויות |
החזרות
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());
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | QuizFeedback | המשוב החדש. המשוב יישאר ריק. |
החזרות
MultipleChoiceItem
— MultipleChoiceItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | QuizFeedback | המשוב החדש |
החזרות
MultipleChoiceItem
— MultipleChoiceItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
MultipleChoiceItem
— MultipleChoiceItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. ברירת המחדל לפריטים חדשים היא 0.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
points | Integer | את מספר הנקודות ששווה פריט שאלה מסוים |
החזרות
MultipleChoiceItem
— MultipleChoiceItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
MultipleChoiceItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
MultipleChoiceItem
— MultipleChoiceItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
ההגדרה קובעת אם לפריט יש אפשרות "אחר". ברירת המחדל ל-CheckboxItem
או ל-MultipleChoiceItem
חדשים היא false
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | true אם לפריט יש האפשרות 'אחר', false אם לא |
החזרות
MultipleChoiceItem
— MultipleChoiceItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms