Class ItemResponse

ItemResponse

תשובה לפריט שאלה אחד בטופס. אפשר לגשת לתגובות לפריטים דרך 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()

הפונקציה מקבלת את פריט השאלה שהתשובה הזו עונה עליו.

החזרות

Item – פריט השאלה שהתשובה הזו עונה עליו

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

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