Come utilizzare Google Apps Script Editor: una guida completa per principianti

Se hai mai avuto bisogno di automatizzare attività su Google Docs, Fogli, Analytics o Gmail, probabilmente ti sei imbattuto in Google Apps Script.È un po’ strano, ma è fondamentalmente la versione Google di VBA in Microsoft Office, ma nel cloud. Puoi personalizzare funzioni, creare macro o persino creare menu personalizzati all’interno dei tuoi servizi Google. Onestamente, una volta presa la mano, è piuttosto potente. Ma armeggiare con l’editor e capire come collegare tutto può essere un po’ intimidatorio all’inizio, soprattutto se non si è abituati alla programmazione o agli IDE.

Ciò che è davvero utile è sapere come accedere all’Apps Script Editor, navigare e connettere altri servizi o API Google. Una volta capito questo, puoi automatizzare un sacco di cose ripetitive e aumentare la produttività. Inoltre, scoprirai quanto è facile aggiungere trigger personalizzati, connettere librerie o persino condividere i tuoi script. L’obiettivo è assicurarti di sapere dove si trova ogni cosa, cosa fa e come iniziare a scrivere i tuoi piccoli script che svolgano tutto il lavoro noioso per te.

Come accedere a Google Apps Script Editor

Accedi tramite Fogli Google, Documenti, Presentazioni, Documenti o Drive

La maggior parte delle persone accede ad Apps Script da Fogli Google, cliccando su Estensioni e poi su Apps Script. Ma se utilizzi Documenti o Presentazioni Google, i passaggi sono piuttosto simili: basta andare su Strumenti e selezionare Editor di script. Per Moduli Google, è un po’ meno ovvio: clicca sui tre puntini in alto a destra e troverai Editor di script. In Drive, fai clic con il pulsante destro del mouse su uno spazio vuoto, quindi vai su Altro e seleziona Google Apps Script. Tieni presente che in alcuni di questi, l’interfaccia potrebbe apparire un po’ datata o nascosta dietro i menu, soprattutto su browser diversi o su dispositivi mobili.

Una volta fatto questo, l’editor di codice si apre in una nuova scheda.È lì che avviene tutta la magia. Per impostazione predefinita, vedrai una funzione di base chiamata myFunction(), che è fondamentalmente un segnaposto. Puoi iniziare a digitare i tuoi script qui: ricorda solo di salvare regolarmente cliccando sull’icona di salvataggio (il floppy disk).Alcune configurazioni, soprattutto se la tua connessione è lenta o il tuo browser non funziona correttamente, potrebbero non salvare automaticamente, quindi cliccare spesso su Salva per evitare di perdere i progressi.

Se vuoi passare da uno script all’altro o da un file all’altro, cerca il riquadro a sinistra: per impostazione predefinita vedrai Code.gs, ma puoi aggiungere altri file.gs o HTML per progetti avanzati. Passa il mouse sulle icone per visualizzare opzioni come la sezione Panoramica, che fornisce informazioni su errori, conteggi delle esecuzioni e altre statistiche. Non sai a cosa serve una funzione? La documentazione di Google è piuttosto buona, ma a volte l’applicazione pratica è un po’ più dettagliata di quanto si legga online.

Navigazione in Google Apps Script Editor

Prendi l’abitudine di cliccare spesso sull’icona Salva : potrebbe sembrare banale, ma nell’ambiente cloud di Google, perdere codice non salvato può rovinarti la giornata. Una volta salvato, l’editor sblocca opzioni come Esegui (per eseguire lo script), Debug (per scorrere il codice passo dopo passo, spesso essenziale in caso di problemi) e il menu a discesa Funzione (per navigare tra i diversi script che hai scritto).

Un’altra funzionalità utile è il registro di esecuzione : mostra errori, avvisi o conferme di esecuzione corretta dello script. Utile, soprattutto durante il debug di funzioni complesse. Se si desidera riutilizzare codice scritto altrove, la scheda Librerie è utile: basta l’ID dello script, una lunga stringa di caratteri che è possibile copiare dalla schermata delle impostazioni del progetto.

Collegamento di servizi API e librerie

Nel menu Servizi, puoi aggiungere API di Google come Analytics, Drive, Calendar e altre ancora. Basta selezionare ” Aggiungi un servizio”, trovare quello che ti serve e premere “Aggiungi”. E voilà, ora il tuo script può richiamare direttamente quelle API. Ad esempio, estraendo dati da Google Analytics o Fogli, qualunque cosa richieda il tuo progetto. Per maggiori dettagli, clicca sui tre puntini accanto a un’API e seleziona ” Vedi documentazione”. Si tratta di un vero e proprio “buco nero” di informazioni, ma vale la pena esplorarlo se vuoi diventare un vero nerd dell’automazione.

E, nota a margine: esplora la sezione Librerie per trovare codice riutilizzabile scritto da altri, soprattutto se vuoi evitare di reinventare la ruota. Ricorda: hai bisogno dell’ID dello script, che si trova nelle impostazioni del progetto: una lunga stringa casuale di caratteri che puoi copiare e incollare nel tuo progetto.

Utilizzo di trigger per automatizzare

Impostalo e dimenticalo con i trigger

Se desideri che il tuo script venga eseguito automaticamente a orari specifici, in caso di modifiche o in seguito a eventi specifici, vai su “Trigger” nel menu a sinistra. Fai clic su “Aggiungi Trigger” e otterrai un modulo gigante per personalizzare esattamente quando e come si attiva lo script. Vuoi che venga eseguito ogni mattina? Seleziona “A tempo” e impostalo. Vuoi che si attivi quando una cella del foglio di calcolo cambia? Imposta il tipo di evento su “In modifica”.Questo ti evita di dover eseguire manualmente le operazioni se devono avvenire in background, il che è essenziale se gestisci report automatizzati o manipolazioni di dati.

La prima volta che si imposta un trigger, potrebbe essere visualizzato il messaggio “Autorizzazione script non riuscita”, soprattutto se sono attivi i blocchi popup. Su Chrome, questo di solito è dovuto a quella piccola icona rossa nella barra degli indirizzi. Basta cliccarci sopra, consentire i popup per il sito e riprovare. Google ti chiederà quindi di autorizzare lo script: è piuttosto semplice, basta seguire le istruzioni. Se hai creato una nuova funzione, devi autorizzarla prima che il trigger funzioni. Il processo prevede la scelta del tuo account Google e l’accettazione delle autorizzazioni, un’operazione un po’ noiosa ma necessaria.

Ah, e se vedi un avviso che lo script non è stato verificato, è normale per gli script personalizzati. Basta cliccare su “Avanzate” e poi su “Vai al progetto (non sicuro)”; sui tuoi script, di solito è abbastanza sicuro. Dopodiché, cliccando su “Consenti” autorizzi tutto. Una volta autorizzati, i trigger funzioneranno senza problemi, almeno finché non cambierai nuovamente le autorizzazioni.

Individuazione dell’ID dello script

Se devi condividere il tuo script o aggiungerlo come libreria altrove, ti servirà l’ID dello script. Come trovarlo? Basta cliccare sull’icona a forma di ingranaggio nella barra laterale sinistra, andare su Impostazioni e cercare nella sezione ID : l’ ID dello script sarà lì, una lunga stringa di caratteri. Copialo e consegnalo o tienilo a portata di mano per i tuoi progetti.

Tutto sommato, Google Apps Script non è troppo complicato una volta che si sa dove si trova tutto e a cosa servono i componenti principali. Vale la pena consultare la documentazione ufficiale di Google, ma non lasciatevi spaventare dal sovraccarico. Una volta acquisita familiarità, creare semplici automazioni diventa davvero facile e le possibilità sono praticamente infinite.

Visti di recente

Questo articolo è stato utile?

In questa pagina