Réponse à une question dans un formulaire. Les réponses aux éléments sont accessibles depuis FormResponse
et créées à partir de n'importe quel Item
demandant au répondant de répondre à une question.
// 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()); } }
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getFeedback() | Object | Récupère les informations fournies pour la réponse envoyée par la personne interrogée. |
getItem() | Item | Récupère l'élément de la question auquel cette réponse répond. |
getResponse() | Object | Récupère la réponse envoyée par la personne interrogée. |
getScore() | Object | Récupère le score de la réponse envoyée par la personne interrogée. |
setFeedback(feedback) | ItemResponse | Définit les commentaires à afficher pour la réponse envoyée par la personne interrogée. |
setScore(score) | ItemResponse | Définit le score de la réponse envoyée par la personne interrogée. |
Documentation détaillée
getFeedback()
Récupère les informations fournies pour la réponse envoyée par la personne interrogée.
Renvois
Object
: un QuizFeedback
pour l'élément de la question
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItem()
Récupère l'élément de la question auquel cette réponse répond.
Renvois
Item
: question à laquelle cette réponse répond.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponse()
Récupère la réponse envoyée par la personne interrogée. Pour la plupart des types d'éléments de question, cela renvoie un String
.
Pour les questions CheckboxItem
, cela renvoie un tableau String[]
contenant les choix du participant. L'ordre des chaînes dans le tableau peut varier.
Pour les questions GridItem
, cela renvoie un tableau String[]
dans lequel la réponse à l'index n
correspond à la question de la ligne n + 1
dans la grille. Si une personne interrogée n'a pas répondu à une question de la grille, cette réponse est renvoyée sous la forme ''
.
Pour les questions CheckboxGridItem
, cela renvoie un tableau String[][]
dans lequel les réponses à l'index de ligne n
correspondent à la question de la ligne n + 1
dans la grille de cases. Si une personne interrogée n'a pas répondu à une question de la grille, cette réponse est renvoyée sous la forme ''
.
Renvois
Object
: String
, String[]
ou String[][]
de réponses à l'élément de la question
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getScore()
Récupère le score de la réponse envoyée par la personne interrogée.
Renvois
Object
: une Double
représentant le score de l'élément de la question
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedback(feedback)
Définit les commentaires à afficher pour la réponse envoyée par la personne interrogée.
Cette méthode n'enregistre pas les commentaires dans Forms tant que Form.submitGrades(responses)
n'est pas appelé avec les réponses FormResponse mises à jour. Consultez setScore()
pour obtenir un exemple.
Paramètres
Nom | Type | Description |
---|---|---|
feedback | Object |
Renvois
ItemResponse
: un ItemResponse
pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setScore(score)
Définit le score de la réponse envoyée par la personne interrogée. Une valeur nulle entraînera la suppression du score existant.
Cette méthode n'enregistre pas le score dans Forms tant que Form.submitGrades(responses)
n'est pas appelé avec les réponses FormResponse mises à jour.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
score | Object |
Renvois
ItemResponse
: un ItemResponse
pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms