Class ItemResponse

ItemResponse

Eine Antwort auf ein Frageelement in einem Formular. Antworten können über FormResponse aufgerufen und über jede Item erstellt werden, in der der Teilnehmer eine Frage beantworten soll.

// 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 zur gesendeten Antwort des Befragten gegeben wurde.
getItem()ItemRuft das Frageelement ab, das mit dieser Antwort beantwortet wird.
getResponse()ObjectRuft die Antwort ab, die der Befragte gesendet hat.
getScore()ObjectRuft die Punktzahl für die gesendete Antwort des Befragten ab.
setFeedback(feedback)ItemResponseLegt das Feedback fest, das für die gesendete Antwort des Befragten angezeigt werden soll.
setScore(score)ItemResponseLegt die Punktzahl für die gesendete Antwort des Befragten fest.

Detaillierte Dokumentation

getFeedback()

Ruft das Feedback ab, das zur gesendeten Antwort des Befragten gegeben wurde.

Rückflug

Object: ein 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.

Rückflug

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 Antwort ab, die der Befragte gesendet hat. Für die meisten Arten von Fragenelementen wird String

Bei CheckboxItem-Fragen wird ein String[]-Array zurückgegeben, das die die Entscheidungen der antwortenden Person. Die Reihenfolge der Strings im Array kann variieren.

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

Bei CheckboxGridItem-Fragen wird ein String[][]-Array zurückgegeben, in dem der Antworten bei Zeilenindex n entspricht der Frage in Zeile n + 1 im Kästchen Raster. Wenn ein Teilnehmer eine Frage im Raster nicht beantwortet hat, wird für diese Antwort '' zurückgegeben.

Rückflug

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

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 gesendete Antwort des Befragten ab.

Rückflug

Object: Ein Double-Wert, der die Punktzahl für das Frageelement darstellt

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 gesendete Antwort des Befragten angezeigt werden soll.

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

Parameter

NameTypBeschreibung
feedbackObject

Rückflug

ItemResponse: Ein 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 gesendete Antwort des Befragten fest. Bei einem Nullwert werden die Punkte.

Bei dieser Methode wird die Punktzahl erst dann in Google Formulare 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".
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

Rückflug

ItemResponse: Ein 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