פריט שאלה שמאפשר למשיבים לבחור אפשרות אחת מתוך רשימה נפתחת. אפשר לגשת לפריטים
וליצור אותם דרך Form
.
// 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?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
createChoice(value) | Choice | יצירת בחירה חדשה. |
createChoice(value, isCorrect) | Choice | יצירת בחירה חדשה. |
createChoice(value, navigationItem) | Choice | יוצרת בחירה חדשה עם אפשרות לניווט בדפים שקופצת לפריט נתון של מעבר דף. |
createChoice(value, navigationType) | Choice | יוצר בחירה חדשה עם אפשרות לניווט בדפים. |
createResponse(response) | ItemResponse | יצירת ItemResponse חדש עבור פריט הרשימה הזה. |
duplicate() | ListItem | יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס. |
getChoices() | Choice[] | קבלת כל האפשרויות לפריט. |
getFeedbackForCorrect() | QuizFeedback | הפונקציה מחזירה את המשוב שמוצג למשיבים כאשר הם עונים כראוי על שאלה. |
getFeedbackForIncorrect() | QuizFeedback | הפונקציה מחזירה את המשוב שמוצג למשיבים כשהם משיבים באופן שגוי לשאלה. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' לפריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס. |
getPoints() | Integer | מחזירה את הערך הנקודתי של פריט שניתן לתת לו ציון. |
getTitle() | String | הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType . |
isRequired() | Boolean | הגדרה זו קובעת אם המשיב חייב לענות על השאלה. |
setChoiceValues(values) | ListItem | מגדירה את האפשרויות של פריט מתוך מערך של מחרוזות. |
setChoices(choices) | ListItem | מגדירה מערך של אפשרויות לפריט. |
setFeedbackForCorrect(feedback) | ListItem | הגדרת המשוב שיוצג למשיבים כאשר הם יענו כראוי לשאלה. |
setFeedbackForIncorrect(feedback) | ListItem | מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה. |
setHelpText(text) | ListItem | מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setPoints(points) | ListItem | הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. |
setRequired(enabled) | ListItem | קובעת אם המשיב חייב לענות על השאלה. |
setTitle(title) | ListItem | מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem ). |
תיעוד מפורט
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
לא תואם לבחירה חוקית עבור פריט זה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
response | String | תשובה חוקית לפריט זה ברשימה |
החזרות
ItemResponse
– התגובה של הפריט
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
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()
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[] | מערך הערכים של הבחירה, שאותם המשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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[] | מגוון של אפשרויות |
החזרות
קליעות
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 | המשוב החדש. המשוב יישאר ריק. |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | QuizFeedback | המשוב החדש |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. ברירת המחדל לפריטים חדשים היא 0.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
points | Integer | את מספר הנקודות ששווה פריט שאלה מסוים |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
ListItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms