Editor di script di Google Apps: tutto ciò che devi sapere per iniziare

Se utilizzi servizi Google come Documenti(Google Docs) Google , Fogli(Google Sheets) Google , Google Analytics , Gmail e altri, puoi connettere e automatizzare tali servizi utilizzando Google Apps Script

Pensa a Google Apps Script come alla versione di Google dello script VBA di Microsoft(Microsoft’s VBA script) . Proprio come puoi automatizzare azioni e attività o personalizzare macro in Microsoft Word ed Excel con VBA(Excel with VBA) , puoi automatizzare attività e azioni nei servizi Google . In servizi come Fogli e Documenti(Docs) , puoi persino scrivere i tuoi menu personalizzati.

In questo articolo imparerai come accedere e abilitare Apps Script nei tuoi vari servizi Google(various Google services) , come navigare nell'Apps Script Editor(Apps Script Editor) e come connettere i servizi. Non imparerai funzioni di script specifiche(learn specific script functions) , ma Google ha un'eccellente documentazione e tutorial sugli script delle app disponibili per imparare a scrivere lo script delle app(Apps Script) .

Come accedere all'editor di script di Google Apps(Access Google Apps Script Editor)

Puoi aprire l' editor di codice di Google Apps Script da una serie di servizi Google . Ad esempio, troverai lo script delle app(Apps Script) nel menu Estensioni(Extensions) all'interno di Fogli Google.

In altri servizi, puoi aprire l' editor di script di Google Apps(Google Apps Script) nei seguenti modi:

  • Documenti Google(Google Docs) : seleziona Editor di script(Script editor) nel menu Strumenti .(Tools)
  • Presentazioni Google(Google Slides) : seleziona Editor di script(Script editor) nel menu Strumenti .(Tools)
  • Moduli Google(Google Forms) : seleziona Editor di script(Script editor) nel menu a tre punti.
  • Google Drive : fai clic con il pulsante destro del mouse su uno spazio vuoto, seleziona Altro(More) e seleziona Google Apps Script .

Utilizzando uno di questi metodi, vedrai l' editor di codice di Apps Script aperto in una nuova scheda. Questa è la finestra in cui scriverai ciascuna delle funzioni che compongono l'intero script. Per impostazione predefinita, vedrai una funzione vuota denominata myFunction() pronta per iniziare a compilare il codice.

Nota(Note) : la formattazione del codice è molto importante per evitare errori. Usa i commenti come mostrato nel codice seguente per ricordare a te stesso cosa stavi cercando di fare all'interno di sezioni di codice. Questo è molto simile a come funzionano i commenti nel codice HTML con la programmazione web.

Mentre navighi nell'editor di codice, puoi tornare a questa sezione selezionando Code.gs nel riquadro di navigazione a sinistra nella finestra Editor . Per vedere altre finestre disponibili, passa con il mouse sulle icone nel riquadro all'estrema sinistra e si aprirà il riquadro di navigazione principale.

La sezione Panoramica(Overview) è dove puoi trovare statistiche sul tuo script come quanti errori si sono verificati, quante volte è stato eseguito e altro ancora.

Tratteremo ciascuna delle altre sezioni dell'editor di script di Google Apps(Google Apps Script) in ciascuna sezione di seguito.

Navigazione nell'editor di script di Google Apps(Google Apps Script Editor)

Quando modifichi il codice nell'editor, è una buona idea selezionare spesso l'icona del disco ( Salva(Save) ) in modo da non perdere il lavoro.

Una volta salvato, vedrai illuminarsi le altre opzioni di menu. 

Questi includono:

  • Esegui(Run) : tenta di eseguire l'intero script dall'inizio alla fine.
  • Debug : passa attraverso il tuo script una riga alla volta.
  • Menu a discesa delle funzioni(Function dropdown) : sfoglia e accedi a ciascuna delle funzioni che hai creato.
  • Registro di esecuzione(Execution log) : visualizza eventuali messaggi di stato o di errore da ogni tentativo che hai effettuato di eseguire lo script.

L' opzione Librerie(Libraries) nel menu di navigazione a sinistra è dove puoi accedere alle librerie che altre persone hanno scritto (o che hai scritto e salvato altrove). Questo è utile se hai un amico che ha già scritto una funzione che vorresti utilizzare in Fogli(Google Sheets) Google o Documenti Google(Google Docs) , ma vorresti aggiungere funzionalità aggiuntive in aggiunta.

Tutto ciò di cui hai bisogno per aggiungere quelle librerie al tuo progetto è l' ID dello script(Script ID) . Puoi trovarlo nella sezione delle impostazioni del progetto, che ti mostreremo come trovare verso la fine di questo articolo.

Componenti aggiuntivi dei servizi di script di Google Apps

La sezione Servizi(Services) è la più utile. È qui che puoi integrare il tuo script attuale con altri servizi Google che potresti utilizzare. 

Quando lo selezioni, vedrai aperta la finestra Aggiungi un servizio . (Add a service)Scorri(Scroll) verso il basso fino al servizio che desideri utilizzare come componente aggiuntivo del tuo progetto esistente. 

Ad esempio, se desideri estrarre i dati dal tuo account Google (Google) Analytics in questo script, puoi selezionare l' API di Google Analytics(Google Analytics API) e selezionare Aggiungi(Add) .

Se vuoi trovare dettagli su quali funzioni sono disponibili per l'uso per quel nuovo servizio aggiuntivo e come usarle, seleziona i tre punti a destra dell'API(API) e seleziona Vedi documentazione(See documentation) .

Questo aprirà la documentazione di Google Apps Script in una nuova scheda, aperta automaticamente nella sezione per quel servizio Google .

Esplora la documentazione per la sintassi delle funzioni, i tutorial e gli esempi di codice che puoi usare nel tuo script.

Inoltre, tieni presente che puoi passare ad altre sezioni della documentazione per vedere quali funzioni generali sono disponibili nel tuo script in base al servizio che stavi utilizzando quando hai originariamente aperto l' editor di codice di Apps Script .

Ad esempio, se hai aperto l'editor in Fogli Google(Google Sheets) , controlla la sezione Fogli(Sheets) nel menu della documentazione per le funzioni di Fogli Google(Google Sheets) che puoi utilizzare nel tuo script.

Configurazione e utilizzo dei trigger di script delle app(Using Apps Script Triggers)

Un'altra utile funzionalità di Google Apps Script è la possibilità di impostare trigger in base a una serie di eventi o pianificazioni.

Per configurare un nuovo trigger per il tuo script, seleziona Trigger(Triggers) dal menu di navigazione all'estrema sinistra. Nella nuova finestra Trigger che si apre, seleziona il pulsante (Triggers)Aggiungi Trigger(Add Trigger) .

La finestra Aggiungi trigger(Add Trigger) ha un lungo elenco di opzioni che ti aiutano a personalizzare esattamente come e quando vuoi che lo script venga eseguito. 

Nota(Note) : molte di queste opzioni dipendono dal servizio per cui stai scrivendo lo script o dalle API che hai aggiunto(the APIs that you’ve added) .

Per impostare il trigger, dovrai scegliere:

  • Quale funzione avviare inizialmente
  • L'origine dell'evento come un'ora, una data specifica o un evento nel tuo servizio, ad esempio quando una cella del foglio di lavoro di Google cambia o viene aperto inizialmente un documento
  • Il tipo di evento, ad esempio quando qualcosa nel tuo foglio di lavoro o documento Google viene aperto o modificato, o l'impostazione specifica per la data o l'ora
  • Frequenza di notifica relativa alla frequenza con cui desideri ricevere aggiornamenti su quando i tuoi script hanno fallito

Dopo aver selezionato Salva(Save) , potresti visualizzare un messaggio " Autorizzazione script non riuscita" se è la prima volta che salvi un nuovo trigger.

Questo di solito viene attivato se hai un blocco popup abilitato nel tuo browser. Se stai utilizzando Google Chrome , seleziona l'icona della piccola finestra con una "X" rossa su di essa. Modificare l'impostazione in Consenti sempre i popup(Always allow pop-ups) e selezionare Fine(Done) .

Quando selezioni nuovamente Salva(Save) , dovrai eseguire la procedura per autorizzare l'esecuzione dello script che hai scritto con il tuo account Google o Google Workspace .

Innanzitutto, seleziona l' account Google con cui desideri consentire l'esecuzione dello script.

Vedrai un avviso che la funzione o lo script personalizzato che hai scritto non è stato "verificato" da Google . Se sei la persona che ha scritto lo script, non importa ed è sicuro eseguirlo con il tuo account(Google Account) Google o Google Workspace .

Per ignorare questo avviso, seleziona Avanzate(Advanced) e quindi seleziona il collegamento Go to <project> (unsafe)

Infine, nella finestra delle autorizzazioni, seleziona Consenti(Allow) per consentire l'esecuzione delle tue funzioni e script personalizzati con il tuo account Google o Google Workspace .

Non dovrai ripetere di nuovo questo processo, solo la prima volta che salvi o esegui i tuoi progetti di script  di Google Apps personalizzati.(Google Apps)

Accesso al tuo ID Google Script

Un'ultima nota: potresti voler fornire il tuo script ad amici o colleghi in modo che possano utilizzare il tuo script o aggiungerlo come libreria al proprio script. 

Puoi trovare il tuo ID Script(Script ID) sotto l' icona Impostazioni(Settings) nel riquadro di navigazione all'estrema sinistra.

Lo Script ID si trova nella sezione ID(IDs) , a destra di Script ID .

Come puoi vedere, l' editor di script di Google Apps(Google Apps Script) è abbastanza semplice se sai come passare a ciascuna funzione che desideri utilizzare. Assicurati solo(Just) di studiare bene la documentazione di Google Apps Script in modo da poter iniziare a imparare come scrivere i tuoi script e tutte le funzioni che sono disponibili per l'uso.



About the author

Sono un ingegnere informatico con oltre 10 anni di esperienza nel settore del software. Sono specializzato nella creazione e manutenzione di applicazioni software individuali e aziendali, nonché nello sviluppo di strumenti di sviluppo per piccole imprese e grandi organizzazioni. Le mie capacità risiedono nello sviluppo di una solida base di codice, negli strumenti di debug e test e nel lavorare a stretto contatto con gli utenti finali per garantire che le loro applicazioni funzionino perfettamente.



Related posts