פריט שאלה שמאפשר למשיב לסמן תיבה אחת או יותר, וגם שדה "אחר" אופציונלי. אפשר לגשת לפריטים או ליצור אותם דרך Form
. כשמשתמשים בבוחן, הפריטים האלה מקבלים ציון אוטומטי.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
clearValidation() | CheckboxItem | פעולה זו מסירה את כל אימות הנתונים של הפריט הזה בתיבת הסימון. |
createChoice(value) | Choice | יצירת בחירה חדשה. |
createChoice(value, isCorrect) | Choice | יצירת בחירה חדשה. |
createResponse(responses) | ItemResponse | יצירת ItemResponse חדש עבור פריט תיבת הסימון הזה. |
duplicate() | CheckboxItem | יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס. |
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) | CheckboxItem | מגדירה את האפשרויות של פריט מתוך מערך של מחרוזות. |
setChoices(choices) | CheckboxItem | מגדירה מערך של אפשרויות לפריט. |
setFeedbackForCorrect(feedback) | CheckboxItem | הגדרת המשוב שיוצג למשיבים כאשר הם יענו כראוי לשאלה. |
setFeedbackForIncorrect(feedback) | CheckboxItem | מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה. |
setHelpText(text) | CheckboxItem | מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setPoints(points) | CheckboxItem | הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. |
setRequired(enabled) | CheckboxItem | קובעת אם המשיב חייב לענות על השאלה. |
setTitle(title) | CheckboxItem | מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | מגדיר את אימות הנתונים של פריט תיבת הסימון הזה. |
showOtherOption(enabled) | CheckboxItem | ההגדרה קובעת אם לפריט יש אפשרות "אחר". |
תיעוד מפורט
clearValidation()
פעולה זו מסירה את כל אימות הנתונים של הפריט הזה בתיבת הסימון.
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
createChoice(value, isCorrect)
יצירת בחירה חדשה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
value | String | ערך הבחירה, שהמשיבים רואים כתווית כאשר הם צופים בטופס |
isCorrect | Boolean | האם הבחירה היא תשובה נכונה |
החזרות
Choice
– האפשרות החדשה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
יצירת ItemResponse
חדש עבור פריט תיבת הסימון הזה. הארגומנט responses
הוא מערך String[]
שמכיל ערכים שצריך לבדוק. הפונקציה מוסיפה ערך חריג אם
ערך כלשהו לא תואם לבחירה תקינה עבור הפריט הזה, אלא אם הערך של showOtherOption(enabled)
מוגדר ל-true
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
responses | String[] | מערך של תשובות תקפות לפריט הזה |
החזרות
ItemResponse
– התגובה של הפריט
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס.
החזרות
CheckboxItem
– עותק משוכפל של CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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[] | מערך הערכים של הבחירה, שאותם המשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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[] | מגוון של אפשרויות |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
קליעות
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 | המשוב החדש. המשוב יישאר ריק. |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
מגדירה את המשוב שיוצג למשיבים כאשר הם משיבים באופן שגוי לשאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | QuizFeedback | המשוב החדש |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. ברירת המחדל לפריטים חדשים היא 0.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
points | Integer | את מספר הנקודות ששווה פריט שאלה מסוים |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
CheckboxItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
מגדיר את אימות הנתונים של פריט תיבת הסימון הזה. העברת ערך null או תיקוף ללא פונקציות נדרשות תגרום להסרת כל האימותים הקודמים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
validation | CheckboxValidation | תיבת סימון שיש להחיל על הפריט הזה. |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
ההגדרה קובעת אם לפריט יש אפשרות "אחר". ברירת המחדל ל-CheckboxItem
או ל-MultipleChoiceItem
חדשים היא false
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | true אם לפריט יש האפשרות 'אחר', false אם לא |
החזרות
CheckboxItem
— CheckboxItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms