Réponse au formulaire dans son ensemble. Un FormResponse
peut être utilisé de trois manières: pour accéder
les réponses envoyées par une personne interrogée (voir getItemResponses()
), de manière programmatique
envoyer une réponse au formulaire (voir withItemResponse(response)
et submit()
) et générer une URL pour le formulaire qui préremplit les champs à l'aide des
réponses. Vous pouvez créer des FormResponse
et y accéder à partir d'un Form
.
// 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 |
---|---|---|
getEditResponseUrl() | String | Génère une URL qui permet de modifier une réponse déjà envoyée. |
getGradableItemResponses() | ItemResponse[] | Récupère toutes les réponses aux éléments contenues dans une réponse à un formulaire, dans le même ordre que les éléments. dans le formulaire. |
getGradableResponseForItem(item) | ItemResponse | Récupère la réponse d'é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[] | Récupère toutes les réponses aux éléments contenues dans une réponse à un formulaire, dans le même ordre que les éléments. 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 à un élément donné contenue dans cette réponse au formulaire. |
getTimestamp() | Date | Récupère le code temporel correspondant à 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 ce de réponse au formulaire. |
withItemGrade(gradedResponse) | FormResponse | Ajoute les notes de la réponse donnée à une réponse à un formulaire. |
withItemResponse(response) | FormResponse | Ajoute la réponse à un élément donné à une réponse de formulaire. |
Documentation détaillée
getEditResponseUrl()
Génère une URL qui permet de modifier une réponse déjà envoyée. Si le
le paramètre Form.setAllowResponseEdits(enabled)
est désactivé, le lien redirige vers une page qui
explique que la modification des réponses à un formulaire est désactivée. Tous les utilisateurs qui accèdent au lien peuvent modifier la
, bien qu'ils aient besoin d'un compte ayant accès au formulaire si le paramètre Form.setRequireLogin(requireLogin)
est activé. Si le Form.setCollectEmail(collect)
est activé, le formulaire enregistre l'adresse e-mail de l'utilisateur qui a modifié la réponse.
au lieu de l'adresse e-mail
du répondant d'origine.
Pour une réponse de formulaire créée par le script, 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGradableItemResponses()
Récupère toutes les réponses aux éléments contenues dans une réponse à un formulaire, dans le même ordre que les éléments.
dans le formulaire. Cette méthode fonctionne de la même manière que getItemResponses()
, mais pour permettre la notation
une réponse manquante, il renvoie quand même un ItemResponse
si le Item
correspondant
peut être notée (c'est-à-dire attribuer un barème de notation), même en l'absence de réponse réelle. Toutefois, si le
Item
n'est pas gradable. 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 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 élément du formulaire pour lequel la personne interrogée
peut recevoir un score.
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
getGradableResponseForItem(item)
Récupère la réponse d'élément contenue dans une réponse de formulaire pour un élément donné. Cette méthode fonctionne
comme getResponseForItem(item)
, mais pour permettre la notation d'une réponse manquante,
renvoie ItemResponse
si la Item
correspondante peut être notée (c'est-à-dire si un point
), même en l'absence de réponse réelle. Toutefois, si Item
n'est pas gradable,
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 à un élément donné, ou null
s'il n'en existe aucun et que l'élément n'a pas été 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
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 n'a pas été
envoyé.
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
getItemResponses()
Récupère toutes les réponses aux éléments contenues dans une réponse à un formulaire, dans le même ordre que les éléments.
dans le formulaire. Si la réponse du formulaire ne contient pas de réponse pour un TextItem
donné,
DateItem
, TimeItem
ou ParagraphTextItem
, le ItemResponse
renvoyé pour cet élément comportera une chaîne vide comme réponse. Si la réponse au formulaire omet un
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 des réponses à chaque élément du formulaire pour lequel la personne interrogée
a fourni une réponse.
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
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 créée par le script, 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponseForItem(item)
Récupère la réponse à un élément donné contenue dans 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 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
s'il n'en existe aucun.
getTimestamp()
Récupère le code temporel correspondant à l'envoi d'une réponse à un formulaire.
Pour une réponse de formulaire créée par le script, 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
: horodatage 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 correspondant à un ou plusieurs des champs d'application 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 enregistrée dans le magasin de réponses du formulaire.
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
toPrefilledUrl()
Génère une URL pour le formulaire dans lequel les réponses sont préremplies en fonction des réponses de ce de 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
withItemGrade(gradedResponse)
Ajoute les notes de la réponse donnée à une réponse à un formulaire. Cette méthode ne s'applique qu'aux formulaires réponses déjà envoyées et n'affecte les notes stockées qu'une fois qu'elles ont été envoyé. Avec cette méthode, seules les notes des réponses aux éléments sont mises à jour. cela n'affecte pas la réponse réelle (puisque la réponse 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 l'élément "ItemResponse" contient aucune note, cette méthode supprime les notes de l'élément.
// Programmatically award partial credit for a given response var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var formResponses = form.getResponses(); var formItems = form.getItems(); for (var i = 0; i < formResponses.length; i ) { var formResponse = formResponses[i]; for (var j = 0; j < formItems.length; j ) { var item = formItems[j]; var points = item.asMultipleChoiceItem().getPoints(); var itemResponse = formResponse.getGradableResponseForItem(item); Logger.log('Award half credit for answers containing the word "Kennedy"'); var answer = itemResponse.getResponse(); if (answer != null && 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
withItemResponse(response)
Ajoute la réponse à un élément donné à une réponse de formulaire. Cette méthode ne s'applique qu'aux réponses aux questions d'un formulaire. créé par le script, mais pas encore envoyé ; elle ne peut pas affecter les réponses stockées. Si cette est appelée plusieurs fois pour le même élément, seule la dernière réponse d'é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
: FormResponse
, 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