Class ItemResponse

ItemResponse

Eine Antwort auf eine Frage in einem Formular. Auf Elementantworten kann über FormResponse zugegriffen werden. Sie können aus jedem Item erstellt werden, in dem der Teilnehmer aufgefordert wird, eine Frage zu beantworten.

// 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(),
    );
  }
}

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getFeedback()	Object	Ruft das Feedback ab, das für die eingereichte Antwort des Befragten gegeben wurde.
getItem()	Item	Ruft das Frageelement ab, auf das sich diese Antwort bezieht.
getResponse()	Object	Ruft die Antwort ab, die der Teilnehmer gesendet hat.
getScore()	Object	Ruft die Punktzahl für die eingereichte Antwort des Umfrageteilnehmers ab.
setFeedback(feedback)	ItemResponse	Legt das Feedback fest, das für die eingereichte Antwort des Befragten angezeigt werden soll.
setScore(score)	ItemResponse	Legt die Punktzahl für die eingereichte Antwort des Umfrageteilnehmers fest.

Detaillierte Dokumentation

getFeedback()

Ruft das Feedback ab, das für die eingereichte Antwort des Befragten gegeben wurde.

Rückflug

Object – eine QuizFeedback für das Frageelement

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getItem()

Ruft das Frageelement ab, auf das sich diese Antwort bezieht.

Rückflug

Item: Die Frage, auf die sich diese Antwort bezieht

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getResponse()

Ruft die Antwort ab, die der Teilnehmer gesendet hat. Für die meisten Arten von Frageelementen wird hier ein String zurückgegeben.

Bei CheckboxItem-Fragen wird ein String[]-Array mit den Auswahlmöglichkeiten des Antwortenden zurückgegeben. Die Reihenfolge der Strings im Array kann variieren.

Bei GridItem-Fragen wird ein String[]-Array zurückgegeben, in dem die Antwort am Index n der Frage in Zeile n + 1 im Raster entspricht. Wenn ein Teilnehmer eine Frage im Raster nicht beantwortet hat, wird die Antwort als '' zurückgegeben.

Für CheckboxGridItem-Fragen wird ein String[][]-Array zurückgegeben, in dem die Antworten am Zeilenindex n der Frage in Zeile n + 1 im Kontrollkästchenraster entsprechen. Wenn ein Teilnehmer eine Frage im Raster nicht beantwortet hat, wird die Antwort als '' zurückgegeben.

Rückflug

Object – eine String, String[] oder String[][] von Antworten auf die Frage

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getScore()

Ruft die Punktzahl für die eingereichte Antwort des Umfrageteilnehmers ab.

Rückflug

Object: eine Double, die die Punktzahl für das Frageelement darstellt

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

setFeedback(feedback)

Legt das Feedback fest, das für die eingereichte Antwort des Befragten angezeigt werden soll.

Mit dieser Methode wird das Feedback erst in Google Forms gespeichert, wenn Form.submitGrades(responses) mit den aktualisierten FormResponses aufgerufen wird. Ein Beispiel findest du in setScore().

Parameter

Name	Typ	Beschreibung
feedback	Object

Rückflug

ItemResponse – ein ItemResponse für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

setScore(score)

Legt die Punktzahl für die eingereichte Antwort des Umfrageteilnehmers fest. Ein Nullwert löscht den vorhandenen Wert.

Mit dieser Methode wird die Punktzahl erst in Google Forms gespeichert, wenn Form.submitGrades(responses) mit den aktualisierten FormResponses aufgerufen wird.

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

Parameter

Name	Typ	Beschreibung
score	Object

Rückflug

ItemResponse – ein ItemResponse für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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