תשובה לפריט שאלה אחד בטופס. אפשר לגשת לתגובות לפריטים דרך FormResponse
וליצור אותן מכל Item
שבו מבקשים מהמשיב לענות על שאלה.
// Open a form by ID and log the responses to each question. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var formResponses = form.getResponses(); for (var i = 0; i < formResponses.length; i++) { var formResponse = formResponses[i]; var itemResponses = formResponse.getItemResponses(); for (var j = 0; j < itemResponses.length; j++) { var itemResponse = itemResponses[j]; Logger.log('Response #%s to the question "%s" was "%s"', (i + 1).toString(), itemResponse.getItem().getTitle(), itemResponse.getResponse()); } }
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
getFeedback() | Object | קבלת המשוב שניתן על התשובה שהמשיב שלח. |
getItem() | Item | הפונקציה מקבלת את פריט השאלה שהתשובה הזו עונה עליו. |
getResponse() | Object | קבלת התשובה שהמשיב שלח. |
getScore() | Object | הפונקציה מקבלת את הציון של התשובה שנשלחה. |
setFeedback(feedback) | ItemResponse | מגדירה את המשוב שאמור להיות מוצג עבור התשובה שנשלחה. |
setScore(score) | ItemResponse | מגדיר את הציון עבור התשובה שנשלחה. |
תיעוד מפורט
getFeedback()
קבלת המשוב שניתן על התשובה שהמשיב שלח.
החזרות
Object
– QuizFeedback
לפריט השאלה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItem()
getResponse()
קבלת התשובה שהמשיב שלח. לרוב, הפונקציה מחזירה את הערך String
.
בשאלות CheckboxItem
, הפונקציה הזו מחזירה מערך String[]
שמכיל את אפשרויות המשיב. סדר המחרוזות במערך יכול להשתנות.
בתגובה לשאלות מסוג GridItem
, הפונקציה הזו מחזירה מערך String[]
שבו התשובה ב-index n
תואמת לשאלה בשורה n + 1
ברשת. אם המשיב
לא ענה על שאלה בתצוגת המשבצות, התשובה תוחזר כ-''
.
במקרה של שאלות עם CheckboxGridItem
, הפעולה הזו מחזירה מערך String[][]
שבו התשובות באינדקס השורה n
תואמות לשאלה בשורה n + 1
ברשת תיבות הסימון. אם המשיב לא ענה על שאלה בתצוגת המשבצות, התשובה תוחזר כ-''
.
החזרות
Object
— String
או String[]
או String[][]
של תשובות לפריט השאלה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getScore()
הפונקציה מקבלת את הציון של התשובה שנשלחה.
החזרות
Object
– Double
שמייצג את הציון של הפריט עם השאלה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedback(feedback)
מגדירה את המשוב שאמור להיות מוצג עבור התשובה שנשלחה.
השיטה הזו לא שומרת בפועל את המשוב ב-Forms עד שתתבצע קריאה של Form.submitGrades(responses)
ל-FormsResponses המעודכנים. כדי לראות דוגמה, אפשר לעיין בsetScore()
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | Object |
החזרות
ItemResponse
– ItemResponse
לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setScore(score)
מגדיר את הציון עבור התשובה שנשלחה. אם תזינו ערך ריק, המערכת תמחק את הציון הקיים.
השיטה הזו לא תשמור את הציון בפועל ב-Forms עד שתתבצע קריאה ל-Form.submitGrades(responses)
עם התגובות המעודכנות ל-Forms.
// For a multiple choice question with options: "Always true", "Sometimes true", and "Never", // award half credit for responses that answered "Sometimes true". var formResponses = FormApp.getActiveForm().getResponses(); // Go through each form response for (var i = 0; i < formResponses.length; i++) { var response = formResponses[i]; var items = FormApp.getActiveForm().getItems(); // Assume it's the first item var item = items[0]; var itemResponse = response.getGradableResponseForItem(item); // Give half credit for "Sometimes true". if (itemResponse != null && itemResponse.getResponse() == 'Sometimes true') { var points = item.asMultipleChoiceItem().getPoints(); itemResponse.setScore(points * .5); // This saves the grade, but does not submit to Forms yet. response.withItemGrade(itemResponse); } } // Grades are actually submitted to Forms here. FormApp.getActiveForm().submitGrades(formResponses);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
score | Object |
החזרות
ItemResponse
– ItemResponse
לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms