Class Form

Formulaire contenant les propriétés et les éléments généraux. Les propriétés incluent le titre, les paramètres et l'emplacement de stockage des réponses. Les éléments de question incluent des éléments tels que des cases à cocher ou des boutons radio, tandis que les éléments de mise en page 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 élément de question présenté sous forme de grille de colonnes et de lignes, qui permet au répondant de sélectionner plusieurs choix par ligne à partir d'une séquence de cases à cocher.
`addCheckboxItem()`	`CheckboxItem`	Ajoute un élément de question qui permet au répondant de sélectionner une ou plusieurs cases à cocher, ainsi qu'un champ "Autre" facultatif.
`addDateItem()`	`DateItem`	Ajoute un élément de question permettant au répondant d'indiquer une date.
`addDateTimeItem()`	`DateTimeItem`	Ajoute une question permettant au répondant d'indiquer une date et une heure.
`addDurationItem()`	`DurationItem`	Ajoute une question permettant au répondant d'indiquer une durée.
`addEditor(emailAddress)`	`Form`	Ajoute l'utilisateur donné à la liste des éditeurs pour `Form`.
`addEditor(user)`	`Form`	Ajoute l'utilisateur donné à la liste des éditeurs pour `Form`.
`addEditors(emailAddresses)`	`Form`	Ajoute le tableau d'utilisateurs donné à la liste des éditeurs de `Form`.
`addGridItem()`	`GridItem`	Ajoute un élément de question présenté sous la forme d'une grille de colonnes et de lignes, qui permet au répondant de sélectionner un choix par ligne à partir d'une séquence de cases d'option.
`addImageItem()`	`ImageItem`	Ajoute un élément de mise en page qui affiche une image.
`addListItem()`	`ListItem`	Ajoute un élément de question qui permet au répondant de sélectionner un choix dans une liste déroulante.
`addMultipleChoiceItem()`	`MultipleChoiceItem`	Ajoute un élément de question qui permet au répondant de sélectionner un choix dans une liste de cases d'option ou un champ "Autre" facultatif.
`addPageBreakItem()`	`PageBreakItem`	Ajoute un élément de mise en page qui marque le début d'une page.
`addParagraphTextItem()`	`ParagraphTextItem`	Ajoute une question permettant au répondant de saisir un bloc de texte.
`addPublishedReader(emailAddress)`	`Form`	Ajoute l'utilisateur donné à la liste des répondants pour `Form`.
`addPublishedReader(user)`	`Form`	Ajoute l'utilisateur donné à la liste des répondants pour `Form`.
`addPublishedReaders(emailAddresses)`	`Form`	Ajoute le tableau d'utilisateurs donné à la liste des responsables de `Form`.
`addRatingItem()`	`RatingItem`	Ajoute un élément de question qui permet au répondant de donner une note.
`addScaleItem()`	`ScaleItem`	Ajoute un élément de question qui permet au répondant de choisir une option dans une séquence numérotée de cases d'option.
`addSectionHeaderItem()`	`SectionHeaderItem`	Ajoute un élément de mise en page qui indique visuellement le début d'une section.
`addTextItem()`	`TextItem`	Ajoute un élément de question qui permet au répondant de saisir une seule ligne de texte.
`addTimeItem()`	`TimeItem`	Ajoute un élément de question permettant au répondant d'indiquer une heure de la journée.
`addVideoItem()`	`VideoItem`	Ajoute un élément de mise en page qui affiche une vidéo.
`canEditResponse()`	`Boolean`	Détermine si le formulaire affiche un lien permettant de modifier une réponse après l'envoi.
`collectsEmail()`	`Boolean`	Détermine si le formulaire collecte les adresses e-mail des personnes interrogées.
`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 index donné parmi tous les éléments du formulaire.
`deleteItem(item)`	`void`	Supprime l'élément donné.
`deleteResponse(responseId)`	`Form`	Supprime une seule réponse de la base de données des réponses du formulaire.
`getConfirmationMessage()`	`String`	Récupère le message de confirmation du formulaire.
`getCustomClosedFormMessage()`	`String`	Obtient le message personnalisé qui s'affiche si le formulaire n'accepte pas les réponses, ou une chaîne vide si aucun message personnalisé n'est défini.
`getDescription()`	`String`	Récupère la description du formulaire.
`getDestinationId()`	`String`	Obtient 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[]`	Obtient la liste des éditeurs pour ce `Form`.
`getId()`	`String`	Obtient l'ID du formulaire.
`getItemById(id)`	`Item\|null`	Récupère l'élément avec un ID 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é.
`getPublishedReaders()`	`User[]`	Obtient la liste des personnes ayant répondu à cette `Form`.
`getPublishedUrl()`	`String`	Obtient l'URL qui peut être utilisée pour répondre au formulaire.
`getResponse(responseId)`	`FormResponse`	Obtient une seule réponse à un 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 l'ordre des questions sur chaque page du formulaire est aléatoire.
`getSummaryUrl()`	`String`	Obtient l'URL permettant d'afficher un récapitulatif des réponses du 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 répondant.
`hasProgressBar()`	`Boolean`	Détermine si le formulaire affiche une barre de progression.
`hasRespondAgainLink()`	`Boolean`	Détermine si le formulaire affiche un lien permettant d'envoyer une autre réponse une fois qu'un répondant l'a rempli.
`isAcceptingResponses()`	`Boolean`	Détermine si le formulaire accepte actuellement les réponses.
`isPublished()`	`Boolean`	Détermine si le formulaire est publié.
`isPublishingSummary()`	`Boolean`	Détermine si le formulaire affiche un lien permettant de consulter un résumé des réponses une fois qu'un répondant l'a rempli.
`isQuiz()`	`Boolean`	Détermine si le formulaire est un quiz.
`moveItem(from, to)`	`Item`	Déplace un élément à un index donné parmi tous les éléments du formulaire vers un autre index donné.
`moveItem(item, toIndex)`	`Item`	Déplace un élément donné à un index donné parmi tous les éléments du formulaire.
`removeDestination()`	`Form`	Dissocie le formulaire de sa destination actuelle pour les réponses.
`removeEditor(emailAddress)`	`Form`	Supprime l'utilisateur donné de la liste des éditeurs pour le `Form`.
`removeEditor(user)`	`Form`	Supprime l'utilisateur donné de la liste des éditeurs pour le `Form`.
`removePublishedReader(emailAddress)`	`Form`	Supprime l'utilisateur donné de la liste des personnes ayant répondu à `Form`.
`removePublishedReader(user)`	`Form`	Supprime l'utilisateur donné de la liste des personnes ayant répondu à `Form`.
`setAcceptingResponses(enabled)`	`Form`	Indique si le formulaire accepte actuellement les réponses.
`setAllowResponseEdits(enabled)`	`Form`	Indique si le formulaire affiche un lien permettant de modifier une réponse après l'envoi.
`setCollectEmail(collect)`	`Form`	Indique si le formulaire collecte les adresses e-mail des personnes interrogées.
`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`	Indique si le formulaire est un questionnaire.
`setLimitOneResponsePerUser(enabled)`	`Form`	Indique si le formulaire n'autorise qu'une seule réponse par répondant.
`setProgressBar(enabled)`	`Form`	Indique si le formulaire comporte une barre de progression.
`setPublished(enabled)`	`Form`	Indique si le formulaire est publié.
`setPublishingSummary(enabled)`	`Form`	Indique si le formulaire affiche un lien permettant de consulter un résumé des réponses après l'envoi du formulaire par une personne interrogée.
`setShowLinkToRespondAgain(enabled)`	`Form`	Indique si le formulaire affiche un lien permettant aux répondants d'envoyer une autre réponse une fois le formulaire rempli.
`setShuffleQuestions(shuffle)`	`Form`	Indique si l'ordre des questions sur chaque page du formulaire est aléatoire.
`setTitle(title)`	`Form`	Définit le titre du formulaire.
`shortenFormUrl(url)`	`String`	Convertit une URL longue de formulaire en URL courte.
`submitGrades(responses)`	`Form`	Envoie les notes pour les réponses au formulaire spécifiées.
`supportsAdvancedResponderPermissions()`	`Boolean`	Détermine si le formulaire est compatible avec la publication.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`requiresLogin()`	`Boolean`	Détermine si le formulaire exige des répondants qu'ils se connectent à un compte du même domaine ou d'un sous-domaine avant de répondre.
`setRequireLogin(requireLogin)`	`Form`	Indique si les personnes interrogées doivent se connecter à un compte du même domaine ou d'un sous-domaine avant de répondre au formulaire.

Documentation détaillée

`addCheckboxGridItem()`

Ajoute un élément de question présenté sous forme de grille de colonnes et de lignes, qui permet au répondant de sélectionner plusieurs choix par ligne à partir d'une séquence 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();

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 avec un ou plusieurs des scopes suivants :

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

`addCheckboxItem()`

Ajoute un élément de question qui permet au répondant de sélectionner une ou plusieurs cases à cocher, ainsi qu'un champ "Autre" facultatif.

// 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 avec un ou plusieurs des scopes suivants :

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

`addDateItem()`

Ajoute un élément de 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 avec un ou plusieurs des scopes suivants :

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

`addDateTimeItem()`

Ajoute une 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 avec un ou plusieurs des scopes suivants :

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

`addDurationItem()`

Ajoute une 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 avec un ou plusieurs des scopes suivants :

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

`addEditor(emailAddress)`

Ajoute l'utilisateur donné à la liste des éditeurs pour Form. Si l'utilisateur figurait déjà dans la liste des spectateurs ou des participants, cette méthode le retire de la 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 editor to the form.
// TODO(developer): replace the emailAddress.
form.addEditor('editor@uni.edu');

Paramètres

Nom	Type	Description
`emailAddress`	`String`	Adresse e-mail de l'utilisateur à ajouter.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`addEditor(user)`

Ajoute l'utilisateur donné à la liste des éditeurs pour Form. Si l'utilisateur figurait déjà dans la liste des spectateurs ou des participants, cette méthode le retire de la liste.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the editors from the old form.
const users = oldForm.getEditors();

// Creates a new form.
const newForm = FormApp.create('New form');

// Adds the editors to a new form.
users.forEach(user => newForm.addEditor(user));

Paramètres

Nom	Type	Description
`user`	`User`	Représentation de l'utilisateur à ajouter.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`addEditors(emailAddresses)`

Ajoute le tableau d'utilisateurs donné à la liste des éditeurs de Form. Si l'un des utilisateurs figurait déjà dans la liste des spectateurs, cette méthode le retire de cette 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 editors to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['editor1@uni.edu', 'editor2@uni.edu']);

Paramètres

Nom	Type	Description
`emailAddresses`	`String[]`	Tableau des adresses e-mail des utilisateurs à ajouter.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`addGridItem()`

Ajoute un élément de question présenté sous la forme d'une grille de colonnes et de lignes, qui permet au répondant de sélectionner un choix par ligne à partir d'une séquence 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 avec un ou plusieurs des scopes suivants :

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

`addImageItem()`

Ajoute un é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 avec un ou plusieurs des scopes suivants :

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

`addListItem()`

Ajoute un élément de question qui permet au répondant de sélectionner un choix dans une liste déroulante.

// 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 avec un ou plusieurs des scopes suivants :

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

`addMultipleChoiceItem()`

Ajoute un élément de question qui permet au répondant de sélectionner un choix dans une liste de cases d'option ou un champ "Autre" facultatif.

// 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 avec un ou plusieurs des scopes suivants :

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

`addPageBreakItem()`

Ajoute un é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 avec un ou plusieurs des scopes suivants :

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

`addParagraphTextItem()`

Ajoute une question permettant au répondant 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 avec un ou plusieurs des scopes suivants :

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

`addPublishedReader(emailAddress)`

Ajoute l'utilisateur donné à la liste des répondants pour Form. Si l'utilisateur figure déjà dans la liste des éditeurs ou des lecteurs, 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');

// Adds responder to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReader('responder@uni.edu');

Paramètres

Nom	Type	Description
`emailAddress`	`String`	Adresse e-mail de l'utilisateur à ajouter.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`addPublishedReader(user)`

Ajoute l'utilisateur donné à la liste des répondants pour Form. Si l'utilisateur figure déjà dans la liste des éditeurs ou des lecteurs, cette méthode n'a aucun effet.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the responders from the old form.
const users = oldForm.getPublishedReaders();

// Creates a new form.
const newForm = FormApp.create('New form');

// Adds the responders to a new form.
users.forEach(user => newForm.addPublishedReader(user));

Paramètres

Nom	Type	Description
`user`	`User`	Représentation de l'utilisateur à ajouter.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`addPublishedReaders(emailAddresses)`

Ajoute le tableau d'utilisateurs donné à la liste des responsables de Form. Si l'utilisateur figure déjà dans la liste des éditeurs ou des lecteurs, 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');

// Adds responders to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['responder1@uni.edu', 'responder2@uni.edu']);

Paramètres

Nom	Type	Description
`emailAddresses`	`String[]`	Tableau des adresses e-mail des utilisateurs à ajouter.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`addRatingItem()`

Ajoute un élément de question qui permet au répondant de donner une note.

// 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 rating item.
const item = form.addRatingItem();

Renvois

RatingItem : élément nouvellement créé.

Autorisation

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

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

`addScaleItem()`

Ajoute un élément de question qui permet au répondant de choisir une option dans une séquence numérotée 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 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 avec un ou plusieurs des scopes suivants :

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

`addSectionHeaderItem()`

Ajoute un é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 avec un ou plusieurs des scopes suivants :

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

`addTextItem()`

Ajoute un élément de question qui permet 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 avec un ou plusieurs des scopes suivants :

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

`addTimeItem()`

Ajoute un élément de 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 avec un ou plusieurs des scopes suivants :

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

`addVideoItem()`

Ajoute un é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 avec un ou plusieurs des scopes suivants :

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

`canEditResponse()`

Détermine si le formulaire affiche un lien permettant de modifier une réponse après l'envoi.

Quel que soit ce paramètre, la méthode FormResponse.getEditResponseUrl() permet à un auteur de script disposant d'un accès en modification au formulaire de générer une URL qui peut être utilisée pour modifier une 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 un lien "Modifier votre réponse", false sinon.

Autorisation

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

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

`collectsEmail()`

Détermine si le formulaire collecte les adresses e-mail des personnes interrogées.

// 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 des adresses e-mail, false dans le cas contraire.

Autorisation

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

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

`createResponse()`

Crée une réponse au formulaire. Pour répondre à une question, créez un ItemResponse à partir de l'élément, puis associez-le à 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 avec un ou plusieurs des scopes 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 les copies des réponses stockées dans une destination de réponse externe (comme une feuille de calcul), mais efface la vue récapitulative du formulaire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`deleteItem(index)`

Supprime l'élément à un index 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 avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes suivants :

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

`deleteResponse(responseId)`

Supprime une seule réponse de la base de données des réponses du formulaire. Cette méthode ne supprime pas les copies des réponses stockées dans une destination de réponse externe (comme une feuille de calcul), mais supprime la réponse de la vue récapitulative du formulaire. L'ID de réponse peut être récupéré avec FormResponse.getId().

Paramètres

Nom	Type	Description
`responseId`	`String`	ID de la réponse au formulaire à supprimer.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`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 avec un ou plusieurs des scopes suivants :

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

`getCustomClosedFormMessage()`

Obtient le message personnalisé qui s'affiche si le formulaire n'accepte pas les réponses, ou une chaîne vide 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 les réponses, ou chaîne vide si aucun message personnalisé n'est défini.

Autorisation

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

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

`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 avec un ou plusieurs des scopes suivants :

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

`getDestinationId()`

Obtient 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 avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes suivants :

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

`getEditors()`

Obtient la liste des éditeurs pour ce Form.

Renvois

User[] : tableau des utilisateurs disposant des droits de modification.

Autorisation

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

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

`getId()`

Obtient 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 avec un ou plusieurs des scopes suivants :

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

`getItemById(id)`

Récupère l'élément avec un ID donné. Renvoie null si l'ID ne correspond pas à un élément 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 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|null : é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 avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes 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 de tous les éléments de ce type.

Autorisation

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

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

`getPublishedReaders()`

Obtient la liste des personnes ayant répondu à ce Form.

// 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 responders for the form.
const users = form.getPublishedReaders();
users.forEach(user => console.log(user.getEmail()));

Renvois

User[] : tableau d'utilisateurs disposant de l'autorisation de répondre.

Autorisation

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

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

`getPublishedUrl()`

Obtient l'URL qui peut être utilisée pour 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 avec un ou plusieurs des scopes suivants :

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

`getResponse(responseId)`

Obtient une seule réponse à un 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 au formulaire.

Génère

Error : si la réponse n'existe pas

Autorisation

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

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

`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 avec un ou plusieurs des scopes 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 pour lesquelles 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 avec un ou plusieurs des scopes suivants :

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

`getShuffleQuestions()`

Détermine si l'ordre des questions sur chaque page du formulaire est aléatoire.

Renvois

Boolean : true si l'ordre des questions sur chaque page du formulaire est aléatoire ; false sinon.

Autorisation

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

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

`getSummaryUrl()`

Obtient l'URL permettant d'afficher un récapitulatif des réponses du formulaire. Sauf si setPublishingSummary(enabled) est défini sur true, seuls les utilisateurs autorisés à modifier le formulaire peuvent 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écapitulatif des réponses.

Autorisation

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

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

`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 avec un ou plusieurs des scopes 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 répondant. 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 dans le cas contraire.

Autorisation

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

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

`hasProgressBar()`

Détermine si le formulaire affiche 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 dans le cas contraire.

Autorisation

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

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

`hasRespondAgainLink()`

Détermine si le formulaire affiche un lien permettant d'envoyer une autre réponse une fois qu'un répondant l'a rempli.

// 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 un lien "Envoyer une autre réponse", false dans le cas contraire.

Autorisation

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

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

`isAcceptingResponses()`

Détermine si le formulaire accepte actuellement les réponses. Cette valeur est remplacée lorsque l'état de publication du formulaire est modifié.

// 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 les réponses, false dans le cas contraire.

Autorisation

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

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

`isPublished()`

Détermine si le formulaire est publié.

Cette fonctionnalité n'est disponible que pour les formulaires compatibles avec la publication. Utilisez supportsAdvancedResponderPermissions() pour vérifier si le formulaire est compatible avec la publication.

// 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 whether the form is published or not and logs it to the console.
console.log(form.isPublished());

Renvois

Boolean : true si le formulaire est publié, false s'il ne l'est pas.

Génère

Error : si l'appel est effectué sur des formulaires non compatibles.

Autorisation

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

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

`isPublishingSummary()`

Détermine si le formulaire affiche un lien permettant de consulter un résumé des réponses une fois qu'un répondant l'a rempli.

// 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 un lien "Afficher les réponses précédentes", false s'il n'en affiche pas.

Autorisation

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

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

`isQuiz()`

Détermine si le formulaire est un quiz.

// 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 les réponses, false dans le cas contraire.

Autorisation

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

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

`moveItem(from, to)`

Déplace un élément à un index donné parmi tous les éléments du formulaire vers un autre index donné. Génère 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 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 avec un ou plusieurs des scopes suivants :

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

`moveItem(item, toIndex)`

Déplace un élément donné à un index donné parmi tous les éléments du formulaire. Génère une exception de script 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 déplacé.

Génère

Error : si l'index est hors limites.

Autorisation

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

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

`removeDestination()`

Dissocie le formulaire de sa destination actuelle pour les réponses. L'ancienne destination dissociée conserve toujours une copie de toutes les réponses précédentes. Tous les formulaires, y compris ceux pour lesquels aucune destination n'est définie explicitement, enregistrent une copie des réponses dans le magasin de réponses du formulaire. Si le formulaire ne comporte pas actuellement de destination pour les réponses, 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 : ce Form, pour le chaînage.

Autorisation

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

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

`removeEditor(emailAddress)`

Supprime l'utilisateur donné de la liste des éditeurs pour le Form. Cette méthode n'empêche pas les utilisateurs d'accéder à Form s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général (par exemple, si Form est partagé avec l'ensemble du domaine de l'utilisateur ou si Form se trouve dans un Drive partagé auquel l'utilisateur peut accéder).Form

Pour les fichiers Drive, cela supprime également l'utilisateur de la liste des lecteurs et des personnes ayant répondu.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Removes the editor from the form.
// TODO(developer): replace the emailAddress.
form.removeEditor('editor@uni.edu');

Paramètres

Nom	Type	Description
`emailAddress`	`String`	Adresse e-mail de l'utilisateur à supprimer.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`removeEditor(user)`

Pour les fichiers Drive, cela supprime également l'utilisateur de la liste des lecteurs.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the editors from the form.
const users = form1.getEditors();

// Opens another form.
// TODO(developer): Replace the URL with your own.
const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit');

// Removes editors from the form.
users.forEach(user => form2.removeEditor(user));

Paramètres

Nom	Type	Description
`user`	`User`	Représentation de l'utilisateur à supprimer.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`removePublishedReader(emailAddress)`

Supprime l'utilisateur donné de la liste des personnes ayant répondu à Form. Cette méthode n'empêche pas les utilisateurs d'accéder à Form s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général (par exemple, si Form est partagé avec l'ensemble du domaine de l'utilisateur ou si Form se trouve dans un Drive partagé auquel l'utilisateur peut accéder).Form

Pour les fichiers Drive, cela supprime également l'utilisateur de la liste des lecteurs et des éditeurs.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Removes the responders from the form.
// TODO(developer): replace the emailAddress.
form.removePublishedReader('responder1@uni.edu');

Paramètres

Nom	Type	Description
`emailAddress`	`String`	Adresse e-mail de l'utilisateur à supprimer.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`removePublishedReader(user)`

Pour les fichiers Drive, cela supprime également l'utilisateur de la liste des lecteurs et des éditeurs.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the responders from the form.
const users = form1.getPublishedReaders();

// Opens another form.
// TODO(developer): Replace the URL with your own.
const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit');

// Removes responders from the form.
users.forEach(user => form2.removePublishedReader(user));

Paramètres

Nom	Type	Description
`user`	`User`	Représentation de l'utilisateur à supprimer.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setAcceptingResponses(enabled)`

Indique si le formulaire accepte actuellement les réponses. La valeur par défaut pour les nouveaux formulaires est true. L'état est remplacé lorsque l'état de publication du formulaire est modifié.

// 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 les réponses, `false` s'il ne doit pas les accepter.

Renvois

Form : ce Form, pour le chaînage.

Génère

Error : si cette option est activée sur un formulaire non publié.

Autorisation

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

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

`setAllowResponseEdits(enabled)`

Indique si le formulaire affiche un lien permettant de modifier une réponse après l'envoi. La valeur par défaut pour les nouveaux formulaires est false.

Quel que soit ce paramètre, la méthode FormResponse.getEditResponseUrl() permet à un auteur de script disposant de l'autorisation de modifier le formulaire de générer une URL qui peut être utilisée pour modifier une 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 un lien "Modifier votre réponse", `false` dans le cas contraire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setCollectEmail(collect)`

Indique si le formulaire collecte les adresses e-mail des personnes interrogées. 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` si ce n'est pas le cas.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`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 : ce Form, pour le chaînage.

Autorisation

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

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

`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 : ce Form, pour le chaînage.

Autorisation

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

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

`setDescription(description)`

Définit la description du formulaire.

Paramètres

Nom	Type	Description
`description`	`String`	Nouvelle description du formulaire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setDestination(type, id)`

Définit la destination où les réponses aux questions du formulaire sont enregistrées. Tous les formulaires, y compris ceux pour lesquels aucune destination n'est définie explicitement, enregistrent une copie des réponses dans leur espace de stockage des 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 : ce Form, pour le chaînage.

Génère

Error : si l'ID de destination fourni n'est pas valide

Autorisation

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

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

`setIsQuiz(enabled)`

Indique 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 quiz. Si vous définissez cette option sur false, toutes les options de notation seront supprimées de toutes les questions.

Les paramètres de questionnaire ne sont disponibles que dans la nouvelle interface utilisateur de Forms. Si vous définissez un formulaire comme questionnaire, il utilisera 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 quiz doivent être activées pour le formulaire, `false` dans le cas contraire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setLimitOneResponsePerUser(enabled)`

Indique si le formulaire n'autorise qu'une seule réponse par répondant. La valeur par défaut pour les nouveaux formulaires est false. Si la valeur est définie sur true, le script ne peut pas du tout envoyer de réponses de formulaire.

Paramètres

Nom	Type	Description
`enabled`	`Boolean`	`true` si le formulaire ne doit autoriser qu'une seule réponse par personne interrogée, `false` dans le cas contraire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setProgressBar(enabled)`

Indique 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` s'il n'en affiche pas.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setPublished(enabled)`

Indique si le formulaire est publié. La valeur par défaut pour les nouveaux formulaires est true.

Un formulaire doit être publié pour être accessible aux personnes interrogées. Cette méthode remplace les appels à setAcceptingResponses(enabled).

// 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',
);

// Publishes the form before sharing it.
form.setPublished(true);

// Checks whether the form is published or not and logs it to the console.
console.log(form.isPublished());

Paramètres

Nom	Type	Description
`enabled`	`Boolean`	`true` si le formulaire doit être publié, `false` dans le cas contraire.

Renvois

Form : ce Form, pour le chaînage.

Génère

Error : si l'appel est effectué sur des formulaires non compatibles.

Autorisation

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

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

`setPublishingSummary(enabled)`

Indique si le formulaire affiche un lien permettant de consulter un résumé des réponses après l'envoi du formulaire par une personne interrogée. La valeur par défaut pour les nouveaux formulaires est false.

Paramètres

Nom	Type	Description
`enabled`	`Boolean`	`true` si le formulaire doit afficher un lien "Afficher les réponses précédentes", `false` dans le cas contraire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setShowLinkToRespondAgain(enabled)`

Indique si le formulaire affiche un lien permettant aux répondants d'envoyer une autre réponse une fois le formulaire rempli. La valeur par défaut pour les nouveaux formulaires est true.

Paramètres

Nom	Type	Description
`enabled`	`Boolean`	`true` si le formulaire doit afficher un lien "Envoyer une autre réponse" ; `false` dans le cas contraire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setShuffleQuestions(shuffle)`

Indique si l'ordre des questions sur chaque page du formulaire est aléatoire.

Paramètres

Nom	Type	Description
`shuffle`	`Boolean`	`true` si l'ordre des questions sur chaque page du formulaire doit être aléatoire ; `false` si ce n'est pas le cas.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`setTitle(title)`

Définit le titre du formulaire.

Paramètres

Nom	Type	Description
`title`	`String`	Nouveau titre du formulaire.

Renvois

Form : ce Form, pour le chaînage.

Autorisation

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

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

`shortenFormUrl(url)`

Convertit une URL longue de formulaire en URL courte. Génère une exception si l'URL longue n'appartient pas à 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 avec un ou plusieurs des scopes suivants :

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

`submitGrades(responses)`

Envoie les notes pour les réponses au formulaire spécifiées.

Si votre code inclut un déclencheur onFormSubmit, l'appel de submitGrades() déclenche la condition onFormSubmit et provoque une boucle infinie. Pour éviter la boucle infinie, ajoutez du code qui vérifie si des 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 : ce Form, pour le chaînage.

Autorisation

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

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

`supportsAdvancedResponderPermissions()`

Détermine si le formulaire est compatible avec la publication. Cette méthode permet de déterminer si les méthodes setPublished(enabled) et isPublished(), ainsi que les autorisations de l'intervenant, sont disponibles.

// 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 whether the form supports publishing or not and logs it to the
// console.
console.log(form.supportsAdvancedResponderPermissions());

Renvois

Boolean : true si le formulaire est compatible avec la publication, false dans le cas contraire.

Autorisation

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

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

Méthodes obsolètes

`requiresLogin()`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Détermine si le formulaire exige des répondants qu'ils se connectent à un compte du même domaine ou d'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 exige que les utilisateurs se connectent, false si ce n'est pas le cas.

`setRequireLogin(requireLogin)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Indique si les personnes interrogées doivent se connecter à un compte du même domaine ou d'un sous-domaine avant de répondre au formulaire. La valeur par défaut des nouveaux formulaires est false, sauf si un administrateur de domaine la modifie.

Cette fonctionnalité n'est disponible que pour les formulaires créés par les utilisateurs Google Workspace. Les utilisateurs d'autres types de comptes Google ne peuvent pas être tenus de 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 exige que les utilisateurs se connectent ; `false` s'il ne l'exige pas.

Renvois

Form : formulaire actuel (pour l'enchaînement).

Autorisation

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

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

Class Form Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Méthodes

Méthodes obsolètes

Documentation détaillée

addCheckboxGridItem()

Renvois

Autorisation

addCheckboxItem()

Renvois

Autorisation

addDateItem()

Renvois

Autorisation

addDateTimeItem()

Renvois

Autorisation

addDurationItem()

Renvois

Autorisation

addEditor(emailAddress)

Paramètres

Renvois

Autorisation

addEditor(user)

Paramètres

Renvois

Autorisation

addEditors(emailAddresses)

Paramètres

Renvois

Autorisation

addGridItem()

Renvois

Autorisation

addImageItem()

Renvois

Autorisation

addListItem()

Renvois

Autorisation

addMultipleChoiceItem()

Renvois

Autorisation

addPageBreakItem()

Renvois

Autorisation

addParagraphTextItem()

Renvois

Autorisation

addPublishedReader(emailAddress)

Paramètres

Renvois

Autorisation

addPublishedReader(user)

Paramètres

Renvois

Autorisation

addPublishedReaders(emailAddresses)

Paramètres

Renvois

Autorisation

addRatingItem()

Renvois

Autorisation

addScaleItem()

Renvois

Autorisation

addSectionHeaderItem()

Renvois

Autorisation

addTextItem()

Renvois

Autorisation

addTimeItem()

Renvois

Autorisation

addVideoItem()

Renvois

Autorisation

canEditResponse()

Class Form

`addCheckboxGridItem()`

`addCheckboxItem()`

`addDateItem()`

`addDateTimeItem()`

`addDurationItem()`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addGridItem()`

`addImageItem()`

`addListItem()`

`addMultipleChoiceItem()`

`addPageBreakItem()`

`addParagraphTextItem()`

`addPublishedReader(emailAddress)`

`addPublishedReader(user)`

`addPublishedReaders(emailAddresses)`

`addRatingItem()`

`addScaleItem()`

`addSectionHeaderItem()`

`addTextItem()`

`addTimeItem()`

`addVideoItem()`

`canEditResponse()`

`collectsEmail()`

`createResponse()`

`deleteAllResponses()`

`deleteItem(index)`

`deleteItem(item)`

`deleteResponse(responseId)`

`getConfirmationMessage()`

`getCustomClosedFormMessage()`

`getDescription()`

`getDestinationId()`

`getDestinationType()`

`getEditUrl()`

`getEditors()`

`getId()`

`getItemById(id)`

`getItems()`

`getItems(itemType)`

`getPublishedReaders()`

`getPublishedUrl()`

`getResponse(responseId)`

`getResponses()`