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().

פרמטרים

שםסוגתיאור
feedbackObject

חזרה

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);

פרמטרים

שםסוגתיאור
scoreObject

חזרה

ItemResponse — ItemResponse לשרשור

אישור

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

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