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

פרמטרים

שם	סוג	תיאור
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".
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