GOOGLE FORMS

FormApp

Les formulaires ou quizz peuvent être également géré via AppScript avec la classe FormApp. Depuis cette classe de base, vous pouvez appeler les fonction suivantes :

OpenById()

Cette fonction permet d'accéder à un formulaire par son identifiant et de récupérer une variable de classe Form

// Ouvrir un formulaire via son identifiant

var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

getActiveForm()

Cette fonction permet d'accéder au formulaire lié au script et de récupérer une variable de classe Form

// Récupère le formulaire auquel le script est lié

//Uniquement pour un script de type container

var form = FormApp.getActiveForm();

Form

getItems()

Cette fonction récupère les questions du formulaire et renvoie un tableau d'objet de classe Item

// Récupère le formulaire auquel le script est lié

//Uniquement pour un script de type container

var form = FormApp.getActiveForm();

//Récupération des questions

var items = form.getItems();

addListItem()

Cette fonction ajoute une question de type liste déroulante dans le formulaire

//Ajout d'une questions avec liste déroulante

var item = form.addListItem()

//Mise du titre sur cette question

item.setTitle("Choisir un créneau")

getResponses()

Cette fonction récupère un tableau de liste de réponses par répondants . Les réponses du formulaire sont classées répondant puis par questions. Cette fonction renvoie un tableau d'objet de classe FormResponse

//Récupération des listes de réponses par répondant

var formResponses = form.getResponses()

Items

setTitle()

Cette fonction permet de définir le titre d'une question

// Récupère le formulaire auquel le script est lié

//Uniquement pour un script de type container

var form = FormApp.getActiveForm();

//Récupération des questions

var items = form.getItems();

//Récupération de la 1ère question du formulaire

var item = items[0];

//Définition du titre

item.setTitle("Votre nom")

asListItem()

Cette fonction renvoie la question comme une question de type liste déroulante. Cette fonction est nécessaire si vous souhaitez modifier les valeurs de la liste déroulante car elle permet de rendre la liste exploitable pour la fonction setChoicesValues(liste_valeurs)

// Récupère le formulaire auquel le script est lié

//Uniquement pour un script de type container

var form = FormApp.getActiveForm();

//Récupération des questions

var items = form.getItems();

//Récupération de la 1ère question du formulaire

var item = items[0];

//Définition du titre et des valeurs de la liste

item.setTitle("Votre nom")

item.asListItem().setChoicesValues(liste_valeurs)

FormResponse

getItemResponse()

Cette fonction envoie les réponses d'un répondant. Ces réponses sont classées dans le même ordre que les questions. Le tableau est composé d'objets de classe ItemResponse

// Récupère le formulaire auquel le script est lié

//Uniquement pour un script de type container

var form = FormApp.getActiveForm();

//Récupération de la liste de réponses du 1er répondan

var formResponses = form.getResponses()[0]

//Récupération des réponses du 1er répondant

var itemResponses = formResponses.getItemResponses();

ItemResponse

getResponse()

Cette fonction permet d'accéder à la réponse de la question sous format texte (Attention : pour les réponse aux question de type Grid, la reponse renvoyé est un tableau)

// Récupère le formulaire auquel le script est lié

//Uniquement pour un script de type container

var form = FormApp.getActiveForm();

//Récupération de la liste de réponses du 1er répondant

var formResponses = form.getResponses()[0]

//Récupération des réponses du 1er répondant

var itemResponses = formResponses.getItemResponses();

//Récupération de l'itemResponse de la 1ere question

var rep_premiere_quest=itemResponses[0]

//Récupération de la réponse sous format texte

var rep_premiere_quest_texte=itemResponses[0].getResponse()