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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getFeedback() | Object | Ruft das Feedback ab, das zur gesendeten Antwort des Befragten gegeben wurde. |
getItem() | Item | Ruft das Frageelement ab, das mit dieser Antwort beantwortet wird. |
getResponse() | Object | Ruft die Antwort ab, die der Befragte gesendet hat. |
getScore() | Object | Ruft die Punktzahl für die gesendete Antwort des Befragten ab. |
setFeedback(feedback) | ItemResponse | Legt das Feedback fest, das für die gesendete Antwort des Befragten angezeigt werden soll. |
setScore(score) | ItemResponse | Legt 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
Name | Typ | Beschreibung |
---|---|---|
feedback | Object |
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
Name | Typ | Beschreibung |
---|---|---|
score | Object |
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