Class FormResponse

FormResponse

Réponse au formulaire dans son ensemble. Un FormResponse peut être utilisé de trois manières : pour accéder aux réponses envoyées par un répondant (voir getItemResponses()), pour envoyer une réponse au formulaire de manière programmatique (voir withItemResponse(response) et submit()) et pour générer une URL pour le formulaire qui préremplit les champs à l'aide des réponses fournies. Les FormResponse peuvent être créés ou accessibles à partir d'un Form.

// 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
getEditResponseUrl()	String	Génère une URL permettant de modifier une réponse déjà envoyée.
getGradableItemResponses()	ItemResponse[]	Obtient toutes les réponses aux questions contenues dans une réponse de formulaire, dans le même ordre que les questions apparaissent dans le formulaire.
getGradableResponseForItem(item)	ItemResponse	Récupère la réponse à un élément contenue dans une réponse de formulaire pour un élément donné.
getId()	String	Récupère l'ID de la réponse au formulaire.
getItemResponses()	ItemResponse[]	Obtient toutes les réponses aux questions contenues dans une réponse de formulaire, dans le même ordre que les questions apparaissent dans le formulaire.
getRespondentEmail()	String	Récupère l'adresse e-mail de la personne qui a envoyé une réponse, si le paramètre Form.setCollectEmail(collect) est activé.
getResponseForItem(item)	ItemResponse	Récupère la réponse à l'élément contenue dans cette réponse au formulaire pour un élément donné.
getTimestamp()	Date	Récupère le code temporel de l'envoi d'une réponse à un formulaire.
submit()	FormResponse	Envoie la réponse.
toPrefilledUrl()	String	Génère une URL pour le formulaire dans lequel les réponses sont préremplies en fonction des réponses de cette réponse au formulaire.
withItemGrade(gradedResponse)	FormResponse	Ajoute les notes de la réponse à l'élément donné à une réponse de formulaire.
withItemResponse(response)	FormResponse	Ajoute la réponse à l'élément donné à une réponse de formulaire.

Documentation détaillée

getEditResponseUrl()

Génère une URL permettant de modifier une réponse déjà envoyée. Si le paramètre Form.setAllowResponseEdits(enabled) est désactivé, le lien redirige vers une page expliquant que la modification des réponses au formulaire est désactivée. Toute personne qui accède au lien peut modifier la réponse, mais elle doit disposer d'un compte ayant accès au formulaire si le paramètre Form.setRequireLogin(requireLogin) est activé. Si le paramètre Form.setCollectEmail(collect) est activé, le formulaire enregistre l'adresse e-mail de l'utilisateur qui a modifié la réponse au lieu de celle du répondant initial.

Pour une réponse de formulaire que le script a créée, mais pas encore envoyée, cette méthode renvoie null.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first form response.
const formResponse = form.getResponses()[0];

// Gets the edit URL for the first form response and logs it to the console.
const editUrl = formResponse.getEditResponseUrl();
console.log(editUrl);

Renvois

String : URL permettant de modifier une réponse envoyée.

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

---

getGradableItemResponses()

Obtient toutes les réponses aux questions contenues dans une réponse de formulaire, dans le même ordre que les questions apparaissent dans le formulaire. Cette méthode fonctionne de la même manière que getItemResponses(), mais pour permettre la notation d'une réponse manquante, elle renvoie toujours un ItemResponse si le Item correspondant peut être noté (c'est-à-dire s'il a une valeur en points), même s'il n'y a pas de réponse réelle. Toutefois, si le Item n'est pas évaluable, cette méthode exclut cet élément de son tableau renvoyé.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Gets the item responses contained in each form response.
for (const formResponse of formResponses) {
  const gradableItemsResponses = formResponse.getGradableItemResponses();

  // Logs the title and score for each item response to the console.
  for (const gradableItemsResponse of gradableItemsResponses) {
    console.log(`${gradableItemsResponse.getItem().getTitle()}
       score ${gradableItemsResponse.getScore()}`);
  }
}

Renvois

ItemResponse[] : tableau des réponses à chaque question du formulaire pour lesquelles le répondant peut recevoir un score.

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

---

getGradableResponseForItem(item)

Récupère la réponse à un élément contenue dans une réponse de formulaire pour un élément donné. Cette méthode fonctionne de la même manière que getResponseForItem(item), mais pour permettre la notation d'une réponse manquante, elle renvoie toujours un ItemResponse si le Item correspondant peut être noté (c'est-à-dire s'il a une valeur en points), même s'il n'y a pas de réponse réelle. Toutefois, si Item n'est pas évaluable, cette méthode renvoie null.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Gets the item responses contained in a form response.
for (const formResponse of formResponses) {
  const formItemResponses = formResponse.getGradableItemResponses();

  // Logs the title and score for responses to the first item of the form.
  const itemResponse = formResponse.getGradableResponseForItem(
      formItemResponses[0].getItem(),
  );
  console.log(
      `${itemResponse.getItem().getTitle()} score ${itemResponse.getScore()}`,
  );
}

Paramètres

Nom	Type	Description
item	Item

Renvois

ItemResponse : réponse pour un élément donné, ou null si aucune réponse n'existe et que l'élément n'est pas noté.

---

getId()

Récupère l'ID de la réponse au formulaire. Cette méthode renvoie null si la réponse au formulaire n'a pas été envoyée.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the form responses and logs the ID for each form response to
// the console.
for (const formResponse of formResponses) {
  console.log(`Response ID: ${formResponse.getId()}`);
}

Renvois

String : ID de la réponse au formulaire ou null si la réponse au formulaire n'a pas été envoyée.

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

---

getItemResponses()

Obtient toutes les réponses aux questions contenues dans une réponse de formulaire, dans le même ordre que les questions apparaissent dans le formulaire. Si la réponse au formulaire ne contient pas de réponse pour un TextItem, DateItem, TimeItem ou ParagraphTextItem donné, le ItemResponse renvoyé pour cet élément aura une chaîne vide comme réponse. Si la réponse au formulaire omet une réponse pour tout autre type d'élément, cette méthode exclut cet élément du tableau renvoyé.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the responses to the form.
const formResponses = form.getResponses();

// Iterates over the responses.
for (const formResponse of formResponses) {
  // Gets the item responses from each form response.
  const itemResponses = formResponse.getItemResponses();

  // Iterates over the item responses.
  for (const itemResponse of itemResponses) {
    // Logs the items' questions and responses to the console.
    console.log(
        `Response to the question '${itemResponse.getItem().getTitle()}' was
      '${itemResponse.getResponse()}'`);
  }
}

Renvois

ItemResponse[] : tableau de réponses à chaque question du formulaire à laquelle le répondant a répondu.

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

---

getRespondentEmail()

Récupère l'adresse e-mail de la personne qui a envoyé une réponse, si le paramètre Form.setCollectEmail(collect) est activé.

Pour une réponse de formulaire que le script a créée, mais pas encore envoyée, cette méthode renvoie null.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs each respondent's email to the console.
// To collect respondent emails, ensure that Form.setCollectEmail(collect) is
// set to true.
for (const formResponse of formResponses) {
  console.log(`Respondent Email: ${formResponse.getRespondentEmail()}`);
}

Renvois

String : adresse e-mail de la personne qui a envoyé cette réponse, si disponible, ou null si le script a créé cette réponse, mais ne l'a pas encore envoyée.

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

---

getResponseForItem(item)

Récupère la réponse à l'élément contenue dans cette réponse au formulaire pour un élément donné.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first item on the form.
const item = form.getItems()[0];

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs each response to the first item to the
// console.
for (const formResponse of formResponses) {
  const itemResponse = formResponse.getResponseForItem(item);
  console.log(itemResponse.getResponse());
}

Paramètres

Nom	Type	Description
item	Item

Renvois

ItemResponse : réponse pour un élément donné, ou null si aucune réponse n'existe.

---

getTimestamp()

Récupère le code temporel de l'envoi d'une réponse à un formulaire.

Pour une réponse de formulaire que le script a créée, mais pas encore envoyée, cette méthode renvoie null.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs the timestamp of each response to the
// console.
for (const formResponse of formResponses) {
  console.log(`Timestamp: ${formResponse.getTimestamp()}`);
}

Renvois

Date : code temporel auquel cette réponse a été envoyée, ou null si le script a créé cette réponse, mais ne l'a pas encore envoyée.

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

---

submit()

Envoie la réponse. Génère une exception de script si la réponse a déjà été envoyée.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Creates an empty response for the form.
const formResponse = form.createResponse();

// Submits an empty response.
formResponse.submit();

Renvois

FormResponse : réponse nouvellement créée et enregistrée dans le magasin de réponses du formulaire.

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

---

toPrefilledUrl()

Génère une URL pour le formulaire dans lequel les réponses sont préremplies en fonction des réponses de cette réponse au formulaire.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first form response.
const formResponse = form.getResponses()[0];

// Generates and logs the URL of a pre-filled form response based on the answers
// of the first form response.
const prefilledUrl = formResponse.toPrefilledUrl();
console.log(prefilledUrl);

Renvois

String : URL d'un formulaire avec des réponses préremplies.

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

---

withItemGrade(gradedResponse)

Ajoute les notes de la réponse à l'élément donné à une réponse de formulaire. Cette méthode ne s'applique qu'aux réponses au formulaire déjà envoyées et n'affecte les notes stockées qu'une fois qu'elles ont été envoyées. Cette méthode ne met à jour que les notes de la réponse à l'élément. Elle n'affecte pas la réponse elle-même (puisqu'elle a déjà été envoyée). Si cette méthode est appelée plusieurs fois pour le même élément, seule la dernière note est conservée. Si ItemResponse ne contient aucune note, cette méthode supprime les notes de l'élément.

// Programmatically award partial credit for a given response
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
const formItems = form.getItems();
for (const formResponse of formResponses) {
  for (const item of formItems) {
    const points = item.asMultipleChoiceItem().getPoints();
    const itemResponse = formResponse.getGradableResponseForItem(item);
    Logger.log('Award half credit for answers containing the word "Kennedy"');
    const answer = itemResponse.getResponse();

    if (answer?.includes('Kennedy')) {
      itemResponse.setScore(points / 2);
      formResponse.withItemGrade(itemResponse);
    }
  }
}
form.submitGrades(formResponses);

Paramètres

Nom	Type	Description
gradedResponse	ItemResponse

Renvois

FormResponse : FormResponse, 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

---

withItemResponse(response)

Ajoute la réponse à l'élément donné à une réponse de formulaire. Cette méthode ne s'applique qu'aux réponses de formulaire que le script a créées, mais pas encore envoyées. Elle ne peut pas affecter les réponses stockées. Si cette méthode est appelée plusieurs fois pour le même élément, seule la dernière réponse de l'élément est conservée.

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Creates a response for the form.
const formResponse = form.createResponse();

// Appends a checkbox item to the form.
const item = form.addCheckboxItem();

// Sets the title of the item to 'Which items are ice cream flavors?'
item.setTitle('Which items are ice cream flavors?');

// Sets choices for the item.
item.setChoices([
  item.createChoice('Vanilla'),
  item.createChoice('Strawberry'),
  item.createChoice('Brick'),
]);

// Creates a response for the item.
const response = item.createResponse(['Vanilla', 'Strawberry']);

// Adds the item response to the form response.
formResponse.withItemResponse(response);

// Submits the form response.
formResponse.submit();

Paramètres

Nom	Type	Description
response	ItemResponse

Renvois

FormResponse : ce FormResponse, 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