Formulaire contenant des propriétés et des éléments généraux. Les propriétés incluent le titre, les paramètres et l'emplacement
des réponses sont stockées. Les éléments comprennent des questions telles que des cases à cocher ou des cases d'option, tandis que la mise en page
les éléments font référence à des éléments
tels que les sauts de page. Vous pouvez accéder aux formulaires ou en créer depuis FormApp
.
// Open a form by ID and create a new spreadsheet. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var ss = SpreadsheetApp.create('Spreadsheet Name'); // Update form properties via chaining. form.setTitle('Form Name') .setDescription('Description of form') .setConfirmationMessage('Thanks for responding!') .setAllowResponseEdits(true) .setAcceptingResponses(false); // Update the form's response destination. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
addCheckboxGridItem() | CheckboxGridItem | Ajoute un nouvel élément à la question, présenté sous la forme d'une grille de colonnes et de lignes, qui permet à la personne interrogée doit sélectionner plusieurs réponses par ligne dans une série de cases à cocher. |
addCheckboxItem() | CheckboxItem | Ajoute un nouvel élément à la question permettant à la personne interrogée de cocher une ou plusieurs cases, comme et une option "other" . |
addDateItem() | DateItem | Ajoute un nouvel élément à la question permettant au répondant d'indiquer une date. |
addDateTimeItem() | DateTimeItem | Ajoute un nouvel élément à la question permettant au répondant d'indiquer une date et une heure. |
addDurationItem() | DurationItem | Ajoute un nouvel élément de question permettant au répondant d'indiquer une durée. |
addEditor(emailAddress) | Form | Ajoute l'utilisateur donné à la liste des éditeurs de Form . |
addEditor(user) | Form | Ajoute l'utilisateur donné à la liste des éditeurs de Form . |
addEditors(emailAddresses) | Form | Ajoute le tableau d'utilisateurs donné à la liste des éditeurs pour Form . |
addGridItem() | GridItem | Ajoute un nouvel élément à la question, présenté sous la forme d'une grille de colonnes et de lignes, qui permet à la personne interrogée à sélectionner une seule réponse par ligne parmi une série de cases d'option. |
addImageItem() | ImageItem | Ajoute un nouvel élément de mise en page qui affiche une image. |
addListItem() | ListItem | Ajoute un nouvel élément à la question permettant à la personne interrogée de sélectionner une réponse dans un menu déroulant liste. |
addMultipleChoiceItem() | MultipleChoiceItem | Ajoute un élément de question permettant au répondant de sélectionner une réponse dans une liste d'options ou une option "Autre" facultative . |
addPageBreakItem() | PageBreakItem | Ajoute un nouvel élément de mise en page qui marque le début d'une page. |
addParagraphTextItem() | ParagraphTextItem | Ajoute un élément de question permettant aux personnes interrogées de saisir un bloc de texte. |
addScaleItem() | ScaleItem | Ajoute un nouvel élément de question permettant à la personne interrogée de choisir une option dans une liste numérotée à l'aide des cases d'option. |
addSectionHeaderItem() | SectionHeaderItem | Ajoute un nouvel élément de mise en page qui indique visuellement le début d'une section. |
addTextItem() | TextItem | Ajoute un nouvel élément à la question permettant au répondant de saisir une seule ligne de texte. |
addTimeItem() | TimeItem | Ajoute un nouvel élément à la question permettant au répondant d'indiquer une heure de la journée. |
addVideoItem() | VideoItem | Ajoute un nouvel élément de mise en page qui affiche une vidéo. |
canEditResponse() | Boolean | Détermine si le formulaire affiche un lien pour modifier une réponse après l'avoir envoyée. |
collectsEmail() | Boolean | Détermine si le formulaire collecte les données des personnes interrogées adresses e-mail. |
createResponse() | FormResponse | Crée une réponse au formulaire. |
deleteAllResponses() | Form | Supprime toutes les réponses envoyées du magasin de réponses du formulaire. |
deleteItem(index) | void | Supprime l'élément à un indice donné parmi tous les éléments du formulaire. |
deleteItem(item) | void | Supprime l'élément donné. |
deleteResponse(responseId) | Form | Supprime une seule réponse du magasin de réponses du formulaire. |
getConfirmationMessage() | String | Récupère le message de confirmation du formulaire. |
getCustomClosedFormMessage() | String | Récupère le message personnalisé qui s'affiche si le formulaire n'accepte pas de réponses, ou si aucun message personnalisé n'est défini. |
getDescription() | String | Récupère la description du formulaire. |
getDestinationId() | String | Récupère l'ID de la destination des réponses du formulaire. |
getDestinationType() | DestinationType | Récupère le type de destination des réponses du formulaire. |
getEditUrl() | String | Récupère l'URL permettant d'accéder au mode Édition du formulaire. |
getEditors() | User[] | Récupère la liste des éditeurs pour cet élément Form . |
getId() | String | Récupère l'ID du formulaire. |
getItemById(id) | Item | Récupère l'élément associé à un identifiant donné. |
getItems() | Item[] | Récupère un tableau de tous les éléments du formulaire. |
getItems(itemType) | Item[] | Récupère un tableau de tous les éléments d'un type donné. |
getPublishedUrl() | String | Récupère l'URL permettant de répondre au formulaire. |
getResponse(responseId) | FormResponse | Récupère une seule réponse de formulaire en fonction de son ID de réponse. |
getResponses() | FormResponse[] | Récupère un tableau de toutes les réponses du formulaire. |
getResponses(timestamp) | FormResponse[] | Récupère un tableau de toutes les réponses du formulaire après une date et une heure données. |
getShuffleQuestions() | Boolean | Détermine si les questions sont présentées dans un ordre aléatoire sur chaque page du formulaire. |
getSummaryUrl() | String | Récupère l'URL permettant d'afficher un résumé des réponses au formulaire. |
getTitle() | String | Récupère le titre du formulaire. |
hasLimitOneResponsePerUser() | Boolean | Détermine si le formulaire n'autorise qu'une seule réponse par personne interrogée. |
hasProgressBar() | Boolean | Détermine si le formulaire doit afficher une barre de progression. |
hasRespondAgainLink() | Boolean | Détermine si le formulaire affiche un lien pour envoyer une autre réponse après la personne interrogée remplit le formulaire. |
isAcceptingResponses() | Boolean | Détermine si le formulaire accepte actuellement des réponses. |
isPublishingSummary() | Boolean | Détermine si le formulaire affiche un lien permettant d'afficher un résumé des réponses après une personne interrogée remplit le formulaire. |
isQuiz() | Boolean | Détermine si le formulaire est un questionnaire. |
moveItem(from, to) | Item | Déplace un élément d'un indice donné entre tous les éléments du formulaire vers un autre indice donné. |
moveItem(item, toIndex) | Item | Déplace un élément donné vers un index donné parmi tous les éléments du formulaire. |
removeDestination() | Form | Dissocie le formulaire de sa destination de réponse actuelle. |
removeEditor(emailAddress) | Form | Supprime l'utilisateur indiqué de la liste des éditeurs pour Form . |
removeEditor(user) | Form | Supprime l'utilisateur indiqué de la liste des éditeurs pour Form . |
requiresLogin() | Boolean | Détermine si le formulaire oblige les personnes interrogées à se connecter à un compte du même domaine ou un sous-domaine avant de répondre. |
setAcceptingResponses(enabled) | Form | Détermine si le formulaire accepte actuellement des réponses. |
setAllowResponseEdits(enabled) | Form | Détermine si le formulaire affiche un lien pour modifier une réponse après l'avoir envoyée. |
setCollectEmail(collect) | Form | Détermine si le formulaire collecte les données des personnes interrogées adresses e-mail. |
setConfirmationMessage(message) | Form | Définit le message de confirmation du formulaire. |
setCustomClosedFormMessage(message) | Form | Définit le message à afficher si le formulaire n'accepte pas de réponses. |
setDescription(description) | Form | Définit la description du formulaire. |
setDestination(type, id) | Form | Définit la destination où les réponses au formulaire sont enregistrées. |
setIsQuiz(enabled) | Form | Détermine si le formulaire est un questionnaire. |
setLimitOneResponsePerUser(enabled) | Form | Détermine si le formulaire n'autorise qu'une seule réponse par personne interrogée. |
setProgressBar(enabled) | Form | Détermine si le formulaire comporte une barre de progression. |
setPublishingSummary(enabled) | Form | Détermine si le formulaire affiche un lien permettant d'afficher le résumé des réponses après l'envoi du formulaire le formulaire. |
setRequireLogin(requireLogin) | Form | Détermine si le formulaire oblige les personnes interrogées à se connecter à un compte appartenant au même domaine ou à un avant de répondre. |
setShowLinkToRespondAgain(enabled) | Form | Détermine si le formulaire affiche un lien pour envoyer une autre réponse une fois que la personne interrogée a rempli le formulaire. |
setShuffleQuestions(shuffle) | Form | Détermine si les questions sont présentées dans un ordre aléatoire sur chaque page du formulaire. |
setTitle(title) | Form | Définit le titre du formulaire. |
shortenFormUrl(url) | String | Convertit l'URL longue d'un formulaire en URL courte. |
submitGrades(responses) | Form | Envoie les notes pour les réponses FormResponses données. |
Documentation détaillée
addCheckboxGridItem()
Ajoute un nouvel élément à la question, présenté sous la forme d'une grille de colonnes et de lignes, qui permet à la personne interrogée doit sélectionner plusieurs réponses par ligne dans une série de cases à cocher.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a checkbox grid item. const item = form.addCheckboxGridItem(); // Sets the title 'Where did you celebrate New Year's?' item.setTitle('Where did you celebrate New Year's?'); // Sets the grid's rows and columns. item.setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Renvois
CheckboxGridItem
: élément nouvellement créé.
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
addCheckboxItem()
Ajoute un nouvel élément à la question permettant à la personne interrogée de cocher une ou plusieurs cases, comme et une option "other" .
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a checkbox item. const item = form.addCheckboxItem(); // Sets the title of the checkbox item to 'Do you prefer cats or dogs?' item.setTitle('Do you prefer cats or dogs?'); // Sets the choices. item.setChoiceValues(['Cats', 'Dogs']);
Renvois
CheckboxItem
: élément nouvellement créé.
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
addDateItem()
Ajoute un nouvel élément à la question permettant au répondant d'indiquer une date.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a date item. const item = form.addDateItem(); // Sets the title to 'When were you born?' item.setTitle('When were you born?'); // Sets the description for the date item. item.setHelpText('Some helper text.');
Renvois
DateItem
: élément nouvellement créé.
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
addDateTimeItem()
Ajoute un nouvel élément à la question permettant au répondant d'indiquer une date et une heure.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a question with date and time inputs. const item = form.addDateTimeItem(); // Sets the title to 'When were you born?' item.setTitle('When were you born?'); // Sets the question as required. item.setRequired(true);
Renvois
DateTimeItem
: élément nouvellement créé.
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
addDurationItem()
Ajoute un nouvel élément de question permettant au répondant d'indiquer une durée.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a question with a duration input. const item = form.addDurationItem(); // Sets the title to 'How long can you hold your breath?' item.setTitle('How long can you hold your breath?'); // Sets the question as required. item.setRequired(true);
Renvois
DurationItem
: élément nouvellement créé.
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
addEditor(emailAddress)
Ajoute l'utilisateur donné à la liste des éditeurs de Form
. Si l'utilisateur était déjà
dans la liste des lecteurs, cette méthode met l'utilisateur hors de la liste des lecteurs.
Paramètres
Nom | Type | Description |
---|---|---|
emailAddress | String | Adresse e-mail de l'utilisateur à ajouter. |
Renvois
Form
: Form
, 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
addEditor(user)
Ajoute l'utilisateur donné à la liste des éditeurs de Form
. Si l'utilisateur était déjà
dans la liste des lecteurs, cette méthode met l'utilisateur hors de la liste des lecteurs.
Paramètres
Nom | Type | Description |
---|---|---|
user | User | Représentation de l'utilisateur à ajouter. |
Renvois
Form
: Form
, 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
addEditors(emailAddresses)
Ajoute le tableau d'utilisateurs donné à la liste des éditeurs pour Form
. Si l'une des valeurs
que les utilisateurs figuraient déjà dans la liste des lecteurs, cette méthode les met en retrait de la liste
les lecteurs.
Paramètres
Nom | Type | Description |
---|---|---|
emailAddresses | String[] | Tableau des adresses e-mail des utilisateurs à ajouter. |
Renvois
Form
: Form
, 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
addGridItem()
Ajoute un nouvel élément à la question, présenté sous la forme d'une grille de colonnes et de lignes, qui permet à la personne interrogée à sélectionner une seule réponse par ligne parmi une série de cases d'option.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a multiple choice grid. const item = form.addGridItem(); // Sets the title to 'Rate your interests.' item.setTitle('Rate your interests'); // Sets the grid's rows and columns. item.setRows(['Cars', 'Computers', 'Celebrities']) .setColumns(['Boring', 'So-so', 'Interesting']);
Renvois
GridItem
: élément nouvellement créé.
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
addImageItem()
Ajoute un nouvel élément de mise en page qui affiche une image.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds an image item. const item = form.addImageItem(); // Gets the Google icon to use as the image. const img = UrlFetchApp.fetch('https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-24dp/logo_googleg_color_1x_web_24dp.png'); // Sets the image, title, and description for the item. item.setTitle('Google icon').setHelpText('Google icon').setImage(img);
Renvois
ImageItem
: élément nouvellement créé.
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
addListItem()
Ajoute un nouvel élément à la question permettant à la personne interrogée de sélectionner une réponse dans un menu déroulant liste.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a dropdown list to the form. const item = form.addListItem(); // Sets the title to 'Do you prefer cats or dogs?' item.setTitle('Do you prefer cats or dogs?'); // Sets the description to 'This is description text...' item.setHelpText('This is description text...'); // Creates and adds choices to the dropdown list. item.setChoices([ item.createChoice('dog'), item.createChoice('cat') ]);
Renvois
ListItem
: élément nouvellement créé.
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
addMultipleChoiceItem()
Ajoute un élément de question permettant au répondant de sélectionner une réponse dans une liste d'options ou une option "Autre" facultative .
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a multiple choice item to the form. const item = form.addMultipleChoiceItem(); // Sets the title. item.setTitle('What is your favorite ice cream flavor?'); // Creates some choice items. const vanilla = item.createChoice('vanilla'); const chocolate = item.createChoice('chocolate'); const strawberry = item.createChoice('strawberry'); // Sets the choices. item.setChoices([vanilla, chocolate, strawberry]);
Renvois
MultipleChoiceItem
: élément nouvellement créé.
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
addPageBreakItem()
Ajoute un nouvel élément de mise en page qui marque le début d'une page.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds page break items to create a second and third page for the form. const pageTwo = form.addPageBreakItem(); const pageThree = form.addPageBreakItem(); // Sets the titles for the pages. pageTwo.setTitle('Page two'); pageThree.setTitle('Page three'); // Upon completion of the first page, sets the form to navigate to the third page. pageTwo.setGoToPage(pageThree); // Upon completion of the second page, sets the form to navigate back to the first page. pageThree.setGoToPage(FormApp.PageNavigationType.RESTART);
Renvois
PageBreakItem
: élément nouvellement créé.
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
addParagraphTextItem()
Ajoute un élément de question permettant aux personnes interrogées de saisir un bloc de texte.
// Opens the form by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds the paragraph text item. const item = form.addParagraphTextItem(); // Sets the title to 'What is your address?' item.setTitle('What is your address?');
Renvois
ParagraphTextItem
: élément nouvellement créé.
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
addScaleItem()
Ajoute un nouvel élément de question permettant au répondant de choisir une option dans une liste numérotée à l'aide des cases d'option.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds the scale item. const item = form.addScaleItem(); // Sets the title of the scale item to 'Choose a number.' item.setTitle('Choose a number'); // Sets the scale to 1-5. item.setBounds(1, 5); // Sets the label for the lower and upper bounds. item.setLabels('Lowest', 'Highest');
Renvois
ScaleItem
: élément nouvellement créé.
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
addSectionHeaderItem()
Ajoute un nouvel élément de mise en page qui indique visuellement le début d'une section.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds the section heading item. const item = form.addSectionHeaderItem(); // Sets the title to 'Title of new section.' item.setTitle('Title of new section'); // Sets the description. item.setHelpText('Description of new section');
Renvois
SectionHeaderItem
: élément nouvellement créé.
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
addTextItem()
Ajoute un nouvel élément à la question permettant au répondant de saisir une seule ligne de texte.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a single-line text item. const item = form.addTextItem(); // Sets the title to 'What is your name?' item.setTitle('What is your name?');
Renvois
TextItem
: élément nouvellement créé.
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
addTimeItem()
Ajoute un nouvel élément à la question permettant au répondant d'indiquer une heure de la journée.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a question with a time input. const item = form.addTimeItem(); // Sets the title to 'What time do you usually wake up in the morning?' item.setTitle('What time do you usually wake up in the morning?');
Renvois
TimeItem
: élément nouvellement créé.
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
addVideoItem()
Ajoute un nouvel élément de mise en page qui affiche une vidéo.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a video item. const item = form.addVideoItem(); // Sets the title, description, and video. item.setTitle('YouTube video') .setHelpText('Send content automatically via Google Sheets and Apps Script') .setVideoUrl('https://youtu.be/xxgQr-jSu9o'); // Sets the alignment to the center. item.setAlignment(FormApp.Alignment.CENTER);
Renvois
VideoItem
: élément nouvellement créé.
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
canEditResponse()
Détermine si le formulaire affiche un lien pour modifier une réponse après l'avoir envoyée.
Quel que soit ce paramètre, la méthode FormResponse.getEditResponseUrl()
autorise un
auteur de script autorisé à modifier le formulaire pour générer une URL permettant de modifier un
de réponse.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Checks if the form displays a link to edit a response after submitting it. // The default is false. To let people edit their responses, use // form.setAllowResponseEdits(true). const edit = form.canEditResponse(); // If the form doesn't let people edit responses, logs false to the console. console.log(edit);
Renvois
Boolean
: true
si le formulaire affiche le message "Edit your response" (Modifier votre réponse) link; false
ne fonctionne pas.
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
collectsEmail()
Détermine si le formulaire collecte les données des personnes interrogées adresses e-mail.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to not collect respondents' email addresses. form.setCollectEmail(false); // Checks whether the form collects respondents' email addresses and logs it to the console. const bool = form.collectsEmail(); console.log(bool);
Renvois
Boolean
: true
si le formulaire collecte les adresses e-mail false
si ce n'est pas le cas.
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
createResponse()
Crée une réponse au formulaire. Pour répondre à une question, créez une ItemResponse
de l'élément, puis joignez-la à cette réponse au formulaire en appelant FormResponse.withItemResponse(response)
. Pour enregistrer la réponse assemblée, appelez FormResponse.submit()
.
Renvois
FormResponse
: réponse au formulaire nouvellement créé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
deleteAllResponses()
Supprime toutes les réponses envoyées du magasin de réponses du formulaire. Cette méthode ne supprime pas des réponses stockées dans un emplacement de réponse externe (comme une feuille de calcul), mais ne contient pas effacer la vue récapitulative du formulaire.
Renvois
Form
: Form
, 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
deleteItem(index)
Supprime l'élément à un indice donné parmi tous les éléments du formulaire. Génère une exception de script si aucun élément n'existe à l'index donné.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets all the items from the form. const items = form.getItems(); // Finds the index of a paragraph text item and deletes it by the item's index. const index = items.findIndex(item => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT); if (index !== -1) { form.deleteItem(index); }
Paramètres
Nom | Type | Description |
---|---|---|
index | Integer | Index de l'élément parmi tous les éléments du formulaire. |
Génère
Error
: si aucun élément n'existe à l'index donné
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
deleteItem(item)
Supprime l'élément donné. Génère une exception de script si l'élément a déjà été supprimé.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets all of the items from the form. const items = form.getItems(); // Finds a paragraph text item and deletes it. const item = items.find(item => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT); if (item) { form.deleteItem(item); }
Paramètres
Nom | Type | Description |
---|---|---|
item | Item | Élément à supprimer. |
Génère
Error
: si l'élément n'existe pas dans le 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
deleteResponse(responseId)
Supprime une seule réponse du magasin de réponses du formulaire. Cette méthode ne supprime pas les copies
stockées dans un emplacement de réponse externe (comme une feuille de calcul), mais ne supprime
dans la vue récapitulative du formulaire. L'ID de réponse peut être récupéré avec FormResponse.getId()
.
<ph type="x-smartling-placeholder">
Paramètres
Nom | Type | Description |
---|---|---|
responseId | String | ID de la réponse au formulaire à supprimer. |
Renvois
Form
: Form
, 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
getConfirmationMessage()
Récupère le message de confirmation du formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the confirmation message to display after someone submits the form. form.setConfirmationMessage('You successfully submitted the form.'); // Gets the confirmation message and logs it to the console. const message = form.getConfirmationMessage(); console.log(message);
Renvois
String
: message de confirmation 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
getCustomClosedFormMessage()
Récupère le message personnalisé qui s'affiche si le formulaire n'accepte pas de réponses, ou si aucun message personnalisé n'est défini.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets a custom closed form message to display to the user when the form // no longer accepts responses. form.setCustomClosedFormMessage('The form is no longer accepting responses.'); // Gets the custom message set for the form and logs it to the console. const message = form.getCustomClosedFormMessage(); console.log(message);
Renvois
String
: message personnalisé à afficher si le formulaire n'accepte pas de réponses ou vide
si aucun message personnalisé n'est défini.
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
getDescription()
Récupère la description du formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form description. form.setDescription('This is the form description.'); // Gets the form description and logs it to the console. const description = form.getDescription(); console.log(description);
Renvois
String
: description 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
getDestinationId()
Récupère l'ID de la destination des réponses du formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Creates a spreadsheet to use as the response destination. const ss = SpreadsheetApp.create('Test_Spreadsheet'); // Updates the form's response destination. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId()); // Gets the ID of the form's response destination and logs it to the console. const destinationId = form.getDestinationId(); console.log(destinationId);
Renvois
String
: ID de la destination des 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
getDestinationType()
Récupère le type de destination des réponses du formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc1234556/edit'); // Gets the type of the form's response destination and logs it to the console. const destinationType = form.getDestinationType().name(); console.log(destinationType);
Renvois
DestinationType
: type de destination des 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
getEditUrl()
Récupère l'URL permettant d'accéder au mode Édition du formulaire.
// Opens the form by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the URL that accesses the form's edit mode and logs it to the console. const url = form.getEditUrl(); console.log(url);
Renvois
String
: URL permettant de modifier le 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
getEditors()
Récupère la liste des éditeurs pour cet élément Form
.
Renvois
User[]
: tableau d'utilisateurs disposant de droits de modification.
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
getId()
Récupère l'ID du formulaire.
// Opens the form by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the ID of the form and logs it to the console. const id = form.getId(); console.log(id);
Renvois
String
: ID 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
getItemById(id)
Récupère l'élément associé à un identifiant donné. Renvoie null
si l'ID ne correspond à aucun élément de
le formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the ID of the first item on the form. const itemId = form.getItems()[0].getId(); // Gets the item from the ID. const item = form.getItemById(itemId); // Gets the name of the item type and logs it to the console. const type = item.getType().name(); console.log(type);
Paramètres
Nom | Type | Description |
---|---|---|
id | Integer | ID de l'article. |
Renvois
Item
: élément avec l'ID donné ou null
si l'élément n'existe pas dans le 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
getItems()
Récupère un tableau de tous les éléments du formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the list of items in the form. const items = form.getItems(); // Gets the type for each item and logs them to the console. const types = items.map((item) => item.getType().name()); console.log(types);
Renvois
Item[]
: tableau de tous les éléments 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
getItems(itemType)
Récupère un tableau de tous les éléments d'un type donné.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets a list of all checkbox items on the form. const items = form.getItems(FormApp.ItemType.CHECKBOX); // Gets the title of each checkbox item and logs them to the console. const checkboxItemsTitle = items.map((item) => item.asCheckboxItem().getTitle()); console.log(checkboxItemsTitle);
Paramètres
Nom | Type | Description |
---|---|---|
itemType | ItemType | Type d'éléments à récupérer. |
Renvois
Item[]
: tableau contenant tous les éléments de ce type.
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
getPublishedUrl()
Récupère l'URL permettant de répondre au formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the URL to respond to the form and logs it to the console. const url = form.getPublishedUrl(); console.log(url);
Renvois
String
: URL permettant de répondre au 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
getResponse(responseId)
Récupère une seule réponse de formulaire en fonction de son ID de réponse. Les ID de réponse peuvent être récupérés à partir de FormResponse.getId()
.
Paramètres
Nom | Type | Description |
---|---|---|
responseId | String | ID de la réponse au formulaire. |
Renvois
FormResponse
: réponse du formulaire.
Génère
Error
: si la réponse n'existe pas
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
getResponses()
Récupère un tableau de toutes les réponses du formulaire.
Renvois
FormResponse[]
: tableau de toutes les 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
getResponses(timestamp)
Récupère un tableau de toutes les réponses du formulaire après une date et une heure données.
Paramètres
Nom | Type | Description |
---|---|---|
timestamp | Date | Date et heure les plus anciennes auxquelles les réponses au formulaire doivent être renvoyées. |
Renvois
FormResponse[]
: liste des réponses au 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
getShuffleQuestions()
Détermine si les questions sont présentées dans un ordre aléatoire sur chaque page du formulaire.
Renvois
Boolean
: true
si les questions sont présentées dans un ordre aléatoire sur chaque page du formulaire
false
si ce n'est pas le cas.
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
getSummaryUrl()
Récupère l'URL permettant d'afficher un résumé des réponses au formulaire. À moins que setPublishingSummary(enabled)
ne soit défini sur true
, seuls les utilisateurs autorisés à modifier le
formulaire peut accéder à l'URL.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // Opens the form by its URL. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the URL to view a summary of the form's responses and logs it to the console. const url = form.getSummaryUrl(); console.log(url);
Renvois
String
: URL permettant d'afficher un résumé des réponses.
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
getTitle()
Récupère le titre du formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the title of the form to 'For_Testing.' form.setTitle('For_Testing'); // Gets the title of the form and logs it to the console. const title = form.getTitle(); console.log(title);
Renvois
String
: titre 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
hasLimitOneResponsePerUser()
Détermine si le formulaire n'autorise qu'une seule réponse par personne interrogée. Si la valeur est true
, le script ne peut pas du tout envoyer de réponses au formulaire.
Renvois
Boolean
: true
si le formulaire n'autorise qu'une seule réponse par personne interrogée false
si ce n'est pas le cas.
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
hasProgressBar()
Détermine si le formulaire doit afficher une barre de progression.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // Opens the form by its URL. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Displays the progress bar on the form. form.setProgressBar(true); // Checks if the form displays a progress bar and logs it to the console. console.log(form.hasProgressBar());
Renvois
Boolean
: true
si le formulaire affiche une barre de progression false
si ce n'est pas le cas.
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
hasRespondAgainLink()
Détermine si le formulaire affiche un lien pour envoyer une autre réponse après la personne interrogée remplit le formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to display a link to submit another // response after someone submits the form. form.setShowLinkToRespondAgain(true); // Checks if the form displays a 'Submit another response' link and logs it to the console. console.log(form.hasRespondAgainLink());
Renvois
Boolean
: true
si le formulaire affiche le message "Envoyer une autre réponse" link; false
ne fonctionne pas.
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
isAcceptingResponses()
Détermine si le formulaire accepte actuellement des réponses.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to accept responses. form.setAcceptingResponses(true); // Checks if the form is accepting responses or not and logs it to the console. const accepting = form.isAcceptingResponses(); console.log(accepting);
Renvois
Boolean
: true
si le formulaire accepte des réponses false
si ce n'est pas le cas.
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
isPublishingSummary()
Détermine si le formulaire affiche un lien permettant d'afficher un résumé des réponses après une personne interrogée remplit le formulaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to display a link to a summary of // the responses after someone submits the form. form.setPublishingSummary(true); // Checks if the form displays a "See previous responses" link and logs it to the console. const publishingLink = form.isPublishingSummary(); console.log(publishingLink);
Renvois
Boolean
: true
si le formulaire affiche les réponses précédentes link; false
ne fonctionne pas.
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
isQuiz()
Détermine si le formulaire est un questionnaire.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form as a quiz. form.setIsQuiz(true); // Checks if the form is a quiz or not and logs it to the console. console.log(form.isQuiz());
Renvois
Boolean
: true
si le formulaire accepte des réponses false
si ce n'est pas le cas.
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
moveItem(from, to)
Déplace un élément d'un indice donné entre tous les éléments du formulaire vers un autre indice donné. Génère une
une exception de script si l'index to
est hors limites.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Moves the first item to be the last item. form.moveItem(0, form.getItems().length - 1);
Paramètres
Nom | Type | Description |
---|---|---|
from | Integer | Index actuel de l'élément parmi tous les éléments du formulaire. |
to | Integer | Nouvel index de l'élément parmi tous les éléments du formulaire. |
Renvois
Item
: élément qui a été déplacé.
Génère
Error
: si l'un des index est hors limites.
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
moveItem(item, toIndex)
Déplace un élément donné vers un index donné parmi tous les éléments du formulaire. Lève un script une exception si l'index donné est hors limites.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the first item. const item = form.getItems()[0]; // Moves the item to be the last item. form.moveItem(item, form.getItems().length - 1);
Paramètres
Nom | Type | Description |
---|---|---|
item | Item | Élément à déplacer. |
toIndex | Integer | Nouvel index de l'élément parmi tous les éléments du formulaire. |
Renvois
Item
: élément qui a été déplacé.
Génère
Error
: si l'index est hors limites.
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
removeDestination()
Dissocie le formulaire de sa destination de réponse actuelle. L'ancienne destination dissociée est toujours conserve une copie de toutes les réponses précédentes. Tous les formulaires, y compris ceux qui n'ont pas de de destination explicitement définies, enregistrez copie des réponses dans le magasin de réponses du formulaire. Si le formulaire ne contient pas de texte destination de la réponse, cette méthode n'a aucun effet.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Opens a spreadsheet to use for the response destination. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Updates the form's response destination to the spreadsheet. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId()); // Unlinks the form from the spreadsheet. form.removeDestination();
Renvois
Form
: Form
, 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
removeEditor(emailAddress)
Supprime l'utilisateur indiqué de la liste des éditeurs pour Form
. Cette méthode ne permet pas
empêcher les utilisateurs d'accéder au Form
s'ils appartiennent à une classe d'utilisateurs ayant
un accès général, par exemple, si le Form
est partagé avec l'ensemble
domaine, ou si Form
se trouve dans un Drive partagé auquel l'utilisateur peut accéder.
Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des lecteurs.
Paramètres
Nom | Type | Description |
---|---|---|
emailAddress | String | Adresse e-mail de l'utilisateur à supprimer. |
Renvois
Form
: Form
, 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
removeEditor(user)
Supprime l'utilisateur indiqué de la liste des éditeurs pour Form
. Cette méthode ne permet pas
empêcher les utilisateurs d'accéder au Form
s'ils appartiennent à une classe d'utilisateurs ayant
un accès général, par exemple, si le Form
est partagé avec l'ensemble
domaine, ou si Form
se trouve dans un Drive partagé auquel l'utilisateur peut accéder.
Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des lecteurs.
Paramètres
Nom | Type | Description |
---|---|---|
user | User | Représentation de l'utilisateur à supprimer. |
Renvois
Form
: Form
, 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
requiresLogin()
Détermine si le formulaire oblige les personnes interrogées à se connecter à un compte du même domaine ou un sous-domaine avant de répondre.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Checks if the form requires respondents to log in to a Google Workspace account // before responding and logs it to the console. const login = form.requiresLogin(); console.log(login);
Renvois
Boolean
: true
si le formulaire nécessite la connexion des utilisateurs false
si ce n'est pas le cas.
setAcceptingResponses(enabled)
Détermine si le formulaire accepte actuellement des réponses. La valeur par défaut pour les nouveaux formulaires est true
.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to accept responses. form.setAcceptingResponses(true); // Checks whether the form is accepting responses or not and logs it to the console. console.log(form.isAcceptingResponses());
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si le formulaire doit accepter des réponses ; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setAllowResponseEdits(enabled)
Détermine si le formulaire affiche un lien pour modifier une réponse après l'avoir envoyée. Par défaut,
nouveaux formulaires est false
.
Quel que soit ce paramètre, la méthode FormResponse.getEditResponseUrl()
autorise un
auteur du script autorisé à modifier le formulaire afin de générer une URL pouvant servir à modifier un
de réponse.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Shows "Edit your response" link after someone submits the form. form.setAllowResponseEdits(true); // Checks whether the option to edit the form after a user submits it is set to true or not // and logs it to the console. console.log(form.canEditResponse());
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si le formulaire doit afficher le message "Edit your response" (Modifier votre réponse) link; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setCollectEmail(collect)
Détermine si le formulaire collecte les données des personnes interrogées adresses e-mail. La valeur par défaut pour les nouveaux formulaires est
false
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to collect respondents' email addresses. form.setCollectEmail(true); // Checks whether the value is set to true or false and logs it to the console. const collect = form.collectsEmail(); console.log(collect);
Paramètres
Nom | Type | Description |
---|---|---|
collect | Boolean | true si le formulaire doit collecter des adresses e-mail ; false
ne fonctionne pas. |
Renvois
Form
: Form
, 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
setConfirmationMessage(message)
Définit le message de confirmation du formulaire.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets a custom confirmation message to display after someone submits the form. form.setConfirmationMessage('Your form has been successfully submitted.'); // Gets the confirmation message set for the form and logs it to the console. const message = form.getConfirmationMessage(); console.log(message);
Paramètres
Nom | Type | Description |
---|---|---|
message | String | Nouveau message de confirmation du formulaire. |
Renvois
Form
: Form
, 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
setCustomClosedFormMessage(message)
Définit le message à afficher si le formulaire n'accepte pas de réponses. Si aucun message n'est défini, le formulaire utilise un message par défaut.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to not accept responses. form.setAcceptingResponses(false); // Sets a custom closed form message to display to the user. form.setCustomClosedFormMessage('The form is no longer accepting responses.'); // Gets the custom message set for the form and logs it to the console. const message = form.getCustomClosedFormMessage(); console.log(message);
Paramètres
Nom | Type | Description |
---|---|---|
message | String | Message à afficher si le formulaire n'accepte pas de réponses. |
Renvois
Form
: Form
, 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
setDescription(description)
Définit la description du formulaire.
Paramètres
Nom | Type | Description |
---|---|---|
description | String | Nouvelle description du formulaire. |
Renvois
Form
: Form
, 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
setDestination(type, id)
Définit la destination où les réponses au formulaire sont enregistrées. Tous les formulaires, y compris ceux qui avez défini explicitement une destination, enregistrez une copie des réponses dans le magasin de réponses.
Paramètres
Nom | Type | Description |
---|---|---|
type | DestinationType | Type de destination des réponses du formulaire. |
id | String | ID de la destination des réponses du formulaire. |
Renvois
Form
: Form
, pour le chaînage.
Génère
Error
: si l'ID de destination donné n'est pas valide
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
setIsQuiz(enabled)
Détermine si le formulaire est un questionnaire. La valeur par défaut pour les nouveaux formulaires est false
.
Les questions notées ne sont autorisées que dans les questionnaires. Si vous définissez cette option sur false
, toutes
les options de notation seront supprimées de toutes les questions.
Les paramètres des questionnaires ne sont disponibles que dans la nouvelle interface de Forms. qui fait un quiz, active le formulaire à utiliser la nouvelle interface utilisateur.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Makes the form a quiz. form.setIsQuiz(true); // Checks whether the form is a quiz or not and logs it to the console. console.log(form.isQuiz());
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si les fonctionnalités de questionnaire doivent être activées pour le formulaire false si
non. |
Renvois
Form
: Form
, 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
setLimitOneResponsePerUser(enabled)
Détermine si le formulaire n'autorise qu'une seule réponse par personne interrogée. La valeur par défaut pour les nouveaux formulaires est
false
Si la valeur est définie sur true
, le script ne peut pas envoyer de réponses au formulaire à l'adresse
tout.
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si le formulaire ne doit autoriser qu'une seule réponse par personne ; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setProgressBar(enabled)
Détermine si le formulaire comporte une barre de progression. La valeur par défaut pour les nouveaux formulaires est false
.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Displays the progress bar on the form. form.setProgressBar(true); // Checks whether the form has a progress bar and logs it to the console. console.log(form.hasProgressBar());
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si le formulaire affiche une barre de progression ; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setPublishingSummary(enabled)
Détermine si le formulaire affiche un lien permettant d'afficher le résumé des réponses après l'envoi du formulaire
le formulaire. La valeur par défaut pour les nouveaux formulaires est false
.
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si le formulaire doit afficher les réponses précédentes link; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setRequireLogin(requireLogin)
Détermine si le formulaire oblige les personnes interrogées à se connecter à un compte appartenant au même domaine ou à un
avant de répondre. La valeur par défaut pour les nouveaux formulaires est false
, sauf si un domaine
l'administrateur modifie la valeur par défaut.
Cette fonctionnalité n'est disponible que pour les formulaires créés par les utilisateurs Google Workspace. Utilisateurs d'autres types de comptes Google ne peuvent pas être requis pour se connecter.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form so that users must log in to their Google Workspace account. form.setRequireLogin(true); // Checks whether the form requires login or not and logs it to the console. console.log(form.requiresLogin());
Paramètres
Nom | Type | Description |
---|---|---|
requireLogin | Boolean | true si le formulaire nécessite que les utilisateurs se connectent ; false
ne fonctionne pas. |
Renvois
Form
: forme actuelle (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
setShowLinkToRespondAgain(enabled)
Détermine si le formulaire affiche un lien pour envoyer une autre réponse une fois que la personne interrogée a rempli
le formulaire. La valeur par défaut pour les nouveaux formulaires est true
.
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si le formulaire doit afficher le message "Envoyer une autre réponse" link; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setShuffleQuestions(shuffle)
Détermine si les questions sont présentées dans un ordre aléatoire sur chaque page du formulaire.
Paramètres
Nom | Type | Description |
---|---|---|
shuffle | Boolean | true si les questions de chaque page du formulaire doivent être classées dans l'ordre suivant :
randomisée ; false si ce n'est pas le cas. |
Renvois
Form
: Form
, 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
setTitle(title)
Définit le titre du formulaire.
Paramètres
Nom | Type | Description |
---|---|---|
title | String | Nouveau titre du formulaire. |
Renvois
Form
: Form
, 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
shortenFormUrl(url)
Convertit l'URL longue d'un formulaire en URL courte. La fonction renvoie une exception si l'URL longue ne répond pas appartiennent à Google Forms.
Paramètres
Nom | Type | Description |
---|---|---|
url | String | URL à raccourcir. |
Renvois
String
: URL au format http://goo.gl/forms/1234
.
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
submitGrades(responses)
Envoie les notes pour les réponses FormResponses données.
Si votre code inclut un déclencheur onFormSubmit
, appeler submitGrades()
déclenche la condition onFormSubmit
et provoque une boucle infinie. Pour éviter que
boucle infinie, ajoutez du code qui vérifie si les notes existent déjà avant d'appeler submitGrades()
.
Paramètres
Nom | Type | Description |
---|---|---|
responses | FormResponse[] | Tableau de toutes les réponses du formulaire. |
Renvois
Form
: Form
, 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