Class ItemResponse

ItemResponse

Réponse à une question d'un formulaire. Vous pouvez accéder aux réponses aux éléments depuis FormResponse et les créer à partir de n'importe quel Item qui demande au répondant de répondre à une question.

// Open a form by ID and log the responses to each question.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
for (let i = 0; i < formResponses.length; i++) {
  const formResponse = formResponses[i];
  const itemResponses = formResponse.getItemResponses();
  for (let j = 0; j < itemResponses.length; j++) {
    const 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 envoyée par le répondant.
getItem()	Item	Récupère l'élément de question auquel cette réponse répond.
getResponse()	Object	Obtient la réponse envoyée par le répondant.
getScore()	Object	Obtient le score de la réponse envoyée par le répondant.
setFeedback(feedback)	ItemResponse	Définit les commentaires qui doivent s'afficher pour la réponse envoyée par le répondant.
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 pour la réponse envoyée par le répondant.

Renvois

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 scopes suivants :

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

---

getItem()

Récupère l'élément de question auquel cette réponse répond.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getResponse()

Obtient la réponse envoyée par le répondant. Pour la plupart des types d'éléments de question, cette méthode renvoie un String.

Pour les questions CheckboxItem, cela renvoie un tableau String[] contenant les choix du répondant. 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 de la grille. Si un répondant n'a pas répondu à une question de la grille, la 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 à la ligne n + 1 dans la grille à cases à cocher. Si un répondant n'a pas répondu à une question de la grille, la réponse est renvoyée sous la forme ''.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getScore()

Obtient le score de la réponse envoyée par le répondant.

Renvois

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 scopes suivants :

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

---

setFeedback(feedback)

Définit les commentaires qui doivent s'afficher pour la réponse envoyée par le répondant.

Cette méthode n'enregistre pas réellement les commentaires dans Forms tant que Form.submitGrades(responses) n'est pas appelé avec les réponses mises à jour du formulaire. Pour consulter un exemple, voir setScore().

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 avec un ou plusieurs des scopes 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 effacera le score existant.

Cette méthode n'enregistre pas réellement le score dans Forms tant que Form.submitGrades(responses) n'est pas appelé avec les réponses mises à jour du formulaire.

// For a multiple choice question with options: "Always true", "Sometimes true",
// and "Never", award half credit for responses that answered "Sometimes true".
const formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (let i = 0; i < formResponses.length; i++) {
  const response = formResponses[i];
  const items = FormApp.getActiveForm().getItems();
  // Assume it's the first item
  const item = items[0];
  const itemResponse = response.getGradableResponseForItem(item);
  // Give half credit for "Sometimes true".
  if (itemResponse != null && itemResponse.getResponse() === 'Sometimes true') {
    const points = item.asMultipleChoiceItem().getPoints();
    itemResponse.setScore(points * 0.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 avec un ou plusieurs des scopes suivants :

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