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)

ההגדרה הזו קובעת את המשוב שיוצג למשיב על התשובה שהוא שלח.

השיטה הזו לא שומרת את המשוב בטפסים עד שמפעילים את Form.submitGrades(responses) עם FormResponses מעודכן. setScore() דוגמה

פרמטרים

שםסוגתיאור
feedbackObject

חזרה

‫ItemResponse – ItemResponse לשרשור

אישור

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

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

setScore(score)

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

השיטה הזו לא שומרת את הציון בטפסים עד שמפעילים את 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