Class ItemResponse

ArtikelAntwort

Eine Antwort auf ein Frageelement in einem Formular. Auf Elementantworten kann über FormResponse zugegriffen und sie können über alle Item erstellt werden, in denen die Befragten aufgefordert werden, 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

MethodeRückgabetypKurzbeschreibung
getFeedback()ObjectDas Feedback, das für die eingereichte Antwort des Teilnehmers gegeben wurde.
getItem()ItemRuft das Frageelement ab, auf das diese Antwort antwortet.
getResponse()ObjectDie Antwort, die der Teilnehmer gesendet hat.
getScore()ObjectDie Punktzahl für die eingereichte Antwort des Teilnehmers.
setFeedback(feedback)ItemResponseHier wird festgelegt, welches Feedback für die eingereichte Antwort des Teilnehmers angezeigt werden soll.
setScore(score)ItemResponseLegt die Punktzahl für die eingereichte Antwort des Teilnehmers fest.

Detaillierte Dokumentation

getFeedback()

Das Feedback, das für die eingereichte Antwort des Teilnehmers gegeben wurde.

Rückflug

Object – ein QuizFeedback für das Frageelement

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getItem()

Ruft das Frageelement ab, auf das diese Antwort antwortet.

Rückflug

Item – das Frageelement, auf das diese Antwort antwortet

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getResponse()

Die Antwort, die der Teilnehmer gesendet hat. Bei den meisten Arten von Frageelementen wird dabei String zurückgegeben.

Bei CheckboxItem-Fragen wird ein String[]-Array zurückgegeben, das die Auswahl der Teilnehmer enthält. Die Reihenfolge der Strings im Array kann variieren.

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

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

Rückflug

Object – eine String oder String[] oder String[][] von Antworten auf das Frageelement

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getScore()

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

Rückflug

Object – ein Double, das die Punktzahl für das Frageelement darstellt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setFeedback(feedback)

Hier wird festgelegt, welches Feedback für die eingereichte Antwort des Teilnehmers 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

NameTypBeschreibung
feedbackObject

Rückflug

ItemResponse – ein ItemResponse für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setScore(score)

Legt die Punktzahl für die eingereichte Antwort des Teilnehmers fest. Bei einem Nullwert wird der vorhandene Wert gelöscht.

Mit dieser Methode wird die Punktzahl erst in Google Forms gespeichert, wenn Form.submitGrades(responses) mit den aktualisierten Formularantworten 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

NameTypBeschreibung
scoreObject

Rückflug

ItemResponse – ein ItemResponse für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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