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

Class ItemResponse

(Réponse de l'article)

Réponse à un élément de question dans un formulaire. Vous pouvez accéder aux réponses aux éléments depuis FormResponse et les créer depuis n'importe quel Item qui demande aux personnes interrogées 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 pour la réponse du participant.
`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 du participant.
`setFeedback(feedback)`	`ItemResponse`	Définit les commentaires à afficher pour la réponse du participant.
`setScore(score)`	`ItemResponse`	Définit le score de la réponse envoyée.

Documentation détaillée

`getFeedback()`

Récupère les commentaires fournis pour la réponse du participant.

Aller-retour

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

Autorisation

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

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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, cette fonction renvoie un tableau String[] contenant les choix du responsable. L'ordre des chaînes dans le tableau peut varier.

Pour les questions GridItem, la fonction renvoie un tableau String[] dans lequel la réponse à l'index n correspond à la question à la ligne n + 1 de la grille. Si la personne interrogée n'a pas répondu à une question dans la grille, cette réponse est renvoyée sous la forme ''.

Pour les questions CheckboxGridItem, un tableau String[][] est renvoyé. Les réponses à l'index de ligne n correspondent à la question à la ligne n + 1 dans la grille de la case à cocher. Si la personne interrogée n'a pas répondu à une question dans la grille, cette réponse est renvoyée sous la forme ''.

Aller-retour

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

Autorisation

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

Aller-retour

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

Autorisation

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

Cette méthode n'enregistre pas les commentaires dans Forms tant que Form.submitGrades(responses) n'est pas appelé avec les nouvelles réponses FormsResponse. Consultez setScore() pour voir un exemple.

Paramètres

Nom	Type	Description
`feedback`	`Object`

Aller-retour

ItemResponse : ItemResponse pour les chaînages

Autorisation

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

Cette méthode n'enregistre pas le score dans Forms tant que Form.submitGrades(responses) n'est pas appelé avec les nouvelles réponses FormsResponse.

// 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`

Aller-retour

ItemResponse : ItemResponse pour les chaînages

Autorisation

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

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