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
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, das mit dieser Antwort beantwortet wird. |
getResponse() | Object | Ruft die vom Teilnehmer gesendete Antwort ab. |
getScore() | Object | Ruft die Punktzahl für die eingereichte Antwort des Befragten 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 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
Name | Typ | Beschreibung |
---|---|---|
feedback | Object |
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
Name | Typ | Beschreibung |
---|---|---|
score | Object |
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