Class ItemResponse

ItemResponse

Eine Antwort auf ein bestimmtes Frageelement in einem Formular. Die Antworten auf die Artikel können über FormResponse aufgerufen und über jede Item erstellt werden, die den Teilnehmer auffordert, eine Frage zu beantworten.

// Open a form by ID and log the responses to each question.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
for (var i = 0; i < formResponses.length; i++) {
  var formResponse = formResponses[i];
  var itemResponses = formResponse.getItemResponses();
  for (var j = 0; j < itemResponses.length; j++) {
    var 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()ObjectRuft das Feedback ab, das für die eingereichte Antwort des Befragten gegeben wurde.
getItem()ItemRuft das Frageelement ab, das mit dieser Antwort beantwortet wird.
getResponse()ObjectRuft die vom Teilnehmer gesendete Antwort ab.
getScore()ObjectRuft die Punktzahl für die eingereichte Antwort des Befragten ab.
setFeedback(feedback)ItemResponseLegt das Feedback fest, das für die eingereichte Antwort des Befragten angezeigt werden soll.
setScore(score)ItemResponseLegt die Punktzahl für die eingereichte Antwort des Befragten fest.

Detaillierte Dokumentation

getFeedback()

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

Return

Object: QuizFeedback für das Frageelement

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getItem()

Ruft das Frageelement ab, das mit dieser Antwort beantwortet wird.

Return

Item – die Frage, die mit dieser Antwort beantwortet wird

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getResponse()

Ruft die vom Teilnehmer gesendete Antwort ab. Für die meisten Arten von Frageelementen wird ein String zurückgegeben.

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

Bei GridItem-Fragen wird ein String[]-Array zurückgegeben, in dem die Antwort bei 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 in 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.

Return

Object: String oder String[] oder String[][] der Antworten auf das Frageelement

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Befragten ab.

Return

Object: Double für die Punktzahl des Frageelements

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • 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 in Google Formulare erst gespeichert, wenn Form.submitGrades(responses) mit den aktualisierten FormResponses aufgerufen wird. Ein Beispiel findest du unter setScore().

Parameter

NameTypBeschreibung
feedbackObject

Return

ItemResponse: ItemResponse für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Befragten fest. Bei einem Nullwert wird der vorhandene Wert gelöscht.

Diese Methode speichert die Punktzahl in Google Formulare erst, 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".
var formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (var i = 0; i < formResponses.length; i++) {
  var response = formResponses[i];
  var items = FormApp.getActiveForm().getItems();
  // Assume it's the first item
  var item = items[0];
  var itemResponse = response.getGradableResponseForItem(item);
  // Give half credit for "Sometimes true".
  if (itemResponse != null && itemResponse.getResponse() == 'Sometimes true') {
    var points = item.asMultipleChoiceItem().getPoints();
    itemResponse.setScore(points * .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

Return

ItemResponse: ItemResponse für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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