Class ItemResponse

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
ItemResponse.

Eine Antwort auf ein Frageelement innerhalb eines Formulars. Antworten auf Artikel können über FormResponse abgerufen und über jeden Item erstellt werden, in dem der Teilnehmer eine Frage beantwortet.

// 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 abgegebene Antwort gegeben wurde.
getItem()ItemRuft das Fragenelement ab, das in dieser Antwort beantwortet wird.
getResponse()ObjectDie Antwort wird abgerufen.
getScore()ObjectLiefert die Punktzahl für die Antwort, die der Teilnehmer gegeben hat.
setFeedback(feedback)ItemResponseLegt das Feedback fest, das für die abgegebene Antwort angezeigt werden soll.
setScore(score)ItemResponseLegt die Punktzahl für die abgegebene Antwort fest.

Detaillierte Dokumentation

getFeedback()

Ruft das Feedback ab, das für die abgegebene Antwort gegeben wurde.

Zurücksenden

Object: QuizFeedback für das Frageelement

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getItem()

Ruft das Fragenelement ab, das in dieser Antwort beantwortet wird.

Zurücksenden

Item: das von dieser Antwort beantwortete Frageelement

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getResponse()

Die Antwort wird abgerufen. Für die meisten Arten von Fragen wird hier ein String zurückgegeben.

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

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

Für CheckboxGridItem-Fragen wird ein String[][]-Array zurückgegeben, in dem die Antworten im Zeilenindex n der Frage in Zeile n + 1 im Rasterraster entsprechen. Wenn eine Teilnehmerin oder ein Teilnehmer keine Frage im Raster beantwortet hat, wird diese Antwort als '' zurückgegeben.

Zurücksenden

Object: String, String[] oder String[][] der Antworten auf die Frage

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getScore()

Liefert die Punktzahl für die Antwort, die der Teilnehmer gegeben hat.

Zurücksenden

ObjectDouble zur Darstellung der Punktzahl für das Frageelement

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setFeedback(feedback)

Legt das Feedback fest, das für die abgegebene Antwort angezeigt werden soll.

Diese Methode speichert das Feedback in Google Formulare erst, wenn Form.submitGrades(responses) mit den aktualisierten Formularantworten aufgerufen wird. Ein Beispiel findest du unter setScore().

Parameter

NameTypBeschreibung
feedbackObject

Zurücksenden

ItemResponse: ItemResponse für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setScore(score)

Legt die Punktzahl für die abgegebene Antwort fest. Ein Nullwert löscht die vorhandene Punktzahl.

Diese Methode speichert den Wert erst dann in Google Formulare, 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".
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

Zurücksenden

ItemResponse: ItemResponse für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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