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() דוגמה

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

‫ItemResponse – ItemResponse לשרשור

אישור

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

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