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[] שבו התשובה האינדקס 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) עם FormResponses המעודכנים. אפשר לראות דוגמה לכך בכתובת setScore().

פרמטרים

שם	סוג	תיאור
feedback	Object

חזרה

ItemResponse — ItemResponse לשרשור

אישור

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

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

---

setScore(score)

מגדיר את הציון של התשובה של המשיב. ערך null ינקה את הערכים הקיימים דירוג.

השיטה הזו לא שומרת בפועל את הציון ב-Forms עד לקריאה של Form.submitGrades(responses) באמצעות FormResponses המעודכנים.

// 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