Cette page a été traduite par l'API Cloud Translation.

Class ItemResponse

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 élément Item qui demande à la personne interrogée 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 commentaires fournis par la personne interrogée.
`getItem()`	`Item`	Récupère l'élément à la question auquel cette réponse répond.
`getResponse()`	`Object`	Récupère la réponse fournie par la personne interrogée.
`getScore()`	`Object`	Récupère le score de la réponse envoyée par le participant.
`setFeedback(feedback)`	`ItemResponse`	Définit les commentaires à afficher pour la réponse envoyée par le participant.
`setScore(score)`	`ItemResponse`	Définit le score de la réponse envoyée par le répondant.

Documentation détaillée

`getFeedback()`

Récupère les commentaires fournis par la personne interrogée.

Renvois

Object : QuizFeedback pour l'élément de la question

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 à la question auquel cette réponse répond.

Renvois

Item : élément de la question auquel cette réponse répond

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 fournie par la personne interrogée. Pour la plupart des types d'éléments de question, un String

Pour les questions CheckboxItem, cela renvoie un tableau String[] contenant les les choix des personnes interrogées. 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 située à la ligne n + 1 de la grille. Si une personne interrogée n'a 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 le réponses à l'index de ligne n correspond à la question à la ligne n + 1 de la case à cocher 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 ''.

Renvois

Object : String, String[] ou String[][] de réponses à la question élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 le participant.

Renvois

Object : Double représentant le score de l'élément de la question

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 le participant.

Cette méthode n'enregistre les commentaires dans Forms qu'une fois que Form.submitGrades(responses) est appelé avec les réponses FormResponses mises à jour. Consultez setScore() pour obtenir un exemple.

Paramètres

Nom	Type	Description
`feedback`	`Object`

Renvois

ItemResponse : ItemResponse pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 le répondant. Une valeur nulle efface le le score.

Cette méthode n'enregistre le score dans Forms qu'une fois que Form.submitGrades(responses) est 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 : ItemResponse pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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