Class ItemResponse

ItemResponse

תשובה לשאלה אחת בטופס. אפשר לגשת לתשובות על הפריטים מ-FormResponse וליצור אותן מכל Item שמבקש מהנשאל לענות על שאלה. 

// Open a form by ID and log the responses to each question.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
for (let i = 0; i < formResponses.length; i++) {
  const formResponse = formResponses[i];
  const itemResponses = formResponse.getItemResponses();
  for (let j = 0; j < itemResponses.length; j++) {
    const itemResponse = itemResponses[j];
    Logger.log(
        'Response #%s to the question "%s" was "%s"',
        (i + 1).toString(),
        itemResponse.getItem().getTitle(),
        itemResponse.getResponse(),
    );
  }
}

Methods

שיטהסוג הערך המוחזרתיאור קצר
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".
const formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (let i = 0; i < formResponses.length; i++) {
  const response = formResponses[i];
  const items = FormApp.getActiveForm().getItems();
  // Assume it's the first item
  const item = items[0];
  const itemResponse = response.getGradableResponseForItem(item);
  // Give half credit for "Sometimes true".
  if (itemResponse != null && itemResponse.getResponse() === 'Sometimes true') {
    const points = item.asMultipleChoiceItem().getPoints();
    itemResponse.setScore(points * 0.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