I vantaggi di creare un Google Form da codice tramite Google Apps Script

Un Google Form personalizzato è uno strumento molto utile per ottenere in modo rapido sondaggi e questionari da sottoporre agli utenti così come test di verifica con puteggio di valutazione per ogni esigenza (un corso online, un'assunzione, ecc...). La loro creazione da interfaccia web è semplice quanto creare un qualsiasi documento della Suite di Google e proprio grazie all'editor WYSIWYG dedicato diventa molto intuitivo andare a comporre le relative domande avvalendosi di diverse tipologia di elementi (risposta aperta, risposta multipla, caricamento di file, ecc...), ordinarle velocemente tramite drag & drop ed aggiungere placeholder ed altre opzioni disponibili, e tutto a portata di mouse.

La domanda che a questo punto vi starete facendo immagino che sia "allora perchè dovrei complicarmi la vita utilizzando Apps Script per creare un Google Form quando posso farlo in modo diretto e più semplice?".
La risposta che darei io è che sicuramente se le cose sono troppo semplici non sono neanche troppo divertenti ma al di là delle battute e delle visioni personali ci sono dei vantaggi che in taluni casi possono rivelarsi effettivamente tangibili ovvero, creando un Google Form con Google Apps Script (e quindi in maniera programmatica) è possibile dinamicizzare processi che permettono di cambiare le domande automaticamente ogni giorno, modificare il modulo per gli stessi o per i futuri intervistati in base alle risposte già fornite oppure aggiungere o rimuovere domande in base a qualsiasi parametro esterno (ad esempio l'ora del giorno, il giorno della settimana, la stagione, ecc...).

L'esempio che vado a presentare metterà in evidenza alcune chiamate ai metodi delle classi del Forms Service volti alla creazione di un sondaggio (nel caso specifico per la raccolta di informazioni sull'interesse sportivo da parte degli utenti) con diverse tipologie di domande ed opzioni attivate.

Il codice integrale scaricabile e molte altre informazioni sulla creazione di Google Form dinamici con Google Apps Script continuano nel mio libro "Punta in alto con... Google Apps Script":

Fig. A - Il libro in italiano - Punta in alto con... Google Apps Script - pag 288 e 289

Troverai tutte le altre informazioni sui form creati programmaticamente con Apps Script come:

- l'uso delle Properties per la memorizzazione delle informazioni a livello di script, documento e utente;
- mostrare messaggi personalizzati tramite throw;
- creazione di campi di testo con addTextItem;
- creazione di campi per l'immissione della data con addDateItem;
- risposte in formato griglia con addGridItem;
- campi che consentono una scelta esclusiva;
- opzioni aggiuntive ed altri metodi descritti e dettagliati nel codice integrale.

...E QUESTO È SOLO QUANTO RIFERITO ALLA GENERAZIONE DI GOOGLE FORMS DINAMICI CON APPS SCRIPT!

ACQUISTA ORA IL LIBRO SU AMAZON:

Se sei pronto a diventare un esperto nella programmazione in Google Apps Script non posso fare altro che augurarti una buona lettura e soprattutto... Buon divertimento!

Il risultato visivo del Form sarà questo (Fig. 1):

Fig. 1 - Risultato di un Google Froms creato con Apps Script

E' importante premettere che i Form di Google si appoggiano ai fogli di calcolo della G Suite (meglio noti come Spreadsheet) sul quale saranno salvate le risposte fornite dagli utenti.
Scorporando lo script in diverse parti per andarle ad analizzare singolarmente possiamo distinguere le diverse operazioni tra le quali quelle designate ad effettuare una iniziale verifica, all'interno delle Properties dello script, della presenza o meno di un identificativo del Form (e di quello del relativo Spreadsheet) salvato, in caso positivo l'operazione viene bloccata (mostrando un messaggio personalizzato tramite throw) in quanto significa che esiste già un form creato con quelle caratteristiche evitandone così la sua duplicazione.
In caso invece di nuova effettiva generazione del form vengono eseguite tutta una serie di operazione finalizzate all'inserimento all'interno del documento delle varie domande che lo compongono.

Al termine della funzione ho inserito un utile riepilogo con le caratteristiche identificative del form (l'url di modifica, l'url di visualizzazione, il suo id) che verranno inserite in un foglio a se stante all'interno dello Spreadsheet precedentemente indicato (Fig. 2), in questo modo è sempre possibile, accedendo direttamente a tale foglio di calcolo di Google (soggetto ad essere maggiormente utilizzati rispetto al Form di per se in quanto contiene la parte utile del sistema, le risposte degli utenti), avere a portata di mano i link per risalire con immediatezza al relativo Google Form:

  scriptProperties.setProperty('formID',formID);
  ss.getSheets()[1].getRange(1,1,4,2).setValues(
    [
      ['Form Url', form.getPublishedUrl()],
      ['Form Edit Url', form.getEditUrl()],
      ['FormID', formID],
      ['Spreadsheet Url', ss.getUrl()]
    ]
  );
  ss.getSheets()[0].setColumnWidth(1,200).setColumnWidth(2,800);

Fig. 2 - Identificativi del Google Form salvati in un foglio all'interno dello Spreadsheet delle risposte del relativo Form

Creando il Form (e lo Spreadsheet) facendo girare così come è il codice proposto in questo tutorial i file verranno creati nella root di Google Drive, se si intende modificare adeguatamente lo script al fine di creare i file in una cartella definita oppure nella cartella dove risiede il progetto Apps Script potete fare riferimento al mio articolo "Spostare i file tra le cartelle di Google Drive con Google Apps Script".

Ho inserito nello script un'ulteriore funzione che non ha niente a che vedere, direttamente, con la creazione di un Google Form in Apps Script ma che, tuttavia, può essere utile per l'esempio oggetto di questo tutorial dato che si fa uso delle PropertiesService per salvare delle coppie di dati chiave-valore a livello di script (l'id del Form e l'id dello Spreadsheet) nel caso volessimo svuotare queste informazioni per creare un nuovo form.

Trovate tutte le info dettagliate corredate di esempi scaricabili nel mio libro "Punta in alto con... Google Apps Script".

Per approfondimenti su altre classi e metodi disponibili per la creazione, accesso e modifica dei Form di Google in modo dinamico rimando alla documentazione ufficiale del Forms Service di Google Apps Script.