Che cos'è Google AppScript?

May 02 2023
Benvenuto! Questo blog sarà una panoramica di Google App Script. Google Apps Script è una piattaforma di scripting basata su cloud che può integrarsi con Google Workspace per estendere le funzionalità di Google Apps e creare applicazioni leggere basate su cloud utilizzando JavaScript.
Script dell'app Google

Benvenuto! Questo blog sarà una panoramica di Google App Script.

Google Apps Script è una piattaforma di scripting basata su cloud che può integrarsi con Google Workspace per estendere le funzionalità di Google Apps e creare applicazioni leggere basate su cloud utilizzando JavaScript.

Offre un editor di codice online facile da usare direttamente nel tuo browser e i tuoi script vengono eseguiti sui server di Google. Fornisce inoltre l'accesso a molte librerie integrate come Gmail, Calendar, Drive, ecc.

Vantaggi dello script dell'app:

  • Aumenta la tua produttività automatizzando le attività ripetitive in Google Workspace.
  • Aggiungi menu, finestre di dialogo e barre laterali personalizzati a Documenti, Fogli e Moduli Google.
  • Scrivi funzioni e macro personalizzate per Fogli Google.
  • Pubblica app web, autonome o incorporate in Google Sites.
  • Interagisci con altri servizi Google, tra cui AdSense, Analytics, Calendar, Drive, Gmail e Maps.
  • Crea componenti aggiuntivi e pubblicali su Google Workspace Marketplace.

▹ Accedi al tuo account Google e vai a Google App Script da qui .
▹ Ecco come appare inizialmente la dashboard.

Un'immagine della dashboard di Google App Script

▹ Facendo clic su Nuovo progetto si accederà alla pagina dell'editor di codice.

Un'immagine delle sezioni del dashboard dello script dell'app Google

▹ L'editor di codice ha più opzioni; iniziamo inserendo il Titolo del Progetto .
▹ Per impostazione predefinita, abbiamo un Code.gsfile (Google Script Extension) che contiene una funzione JavaScript vuota myFunction().

Stampa Hello World in Google App Script

1. Aggiungi console.log(‘hello world’);all'internomyFunction()

function myFunction() {
  console.log('hello world');
}

Un'immagine gif dell'esecuzione di uno script dell'app Google

Trigger

I trigger consentono ad Apps Script di eseguire automaticamente una funzione quando si verifica un determinato evento, come l'apertura di un documento. Passa la funzione attivata a un oggetto evento che contiene informazioni sul contesto in cui si è verificato l'evento. Ci sono 2 tipi di trigger.

  • I trigger semplici sono un insieme di funzioni riservate integrate in Apps Script, come la funzione onOpen(e), che viene eseguita quando un utente apre un file di Documenti, Fogli, Presentazioni o Moduli Google.
  • I trigger installabili offrono più funzionalità rispetto ai trigger semplici, ma devono essere attivati ​​prima dell'uso.
Un'immagine dei tipi di trigger disponibili

Trigger basato sul tempo su App Script

  • Fare clic su Nuovo progetto per creare un nuovo progetto
  • Un'immagine della dashboard dello script dell'app Google
  • Dai un nome al tuo progetto.
  • Un'immagine dell'inserimento del nome per il progetto di script dell'app Google
  • Dentro myFunction, scrivi il codice che dovrebbe essere eseguito dal trigger.
  • Un'immagine del salvataggio dello script delle app di Google
  • Fai clic su Trigger dal menu e crea un trigger.
  • Un'immagine con l'opzione trigger
  • Scegli l'impostazione di trigger desiderata e fai clic su Save , ad esempio ho scelto Event Source come Time-driven, Trigger Type come Minutes Timer e Minute Interval come every minute.
  • Un'immagine con le impostazioni del trigger di script dell'app Google
  • Questa impostazione eseguirà il codice per ogni minuto.
  • Una volta salvato, puoi visualizzare tutti i tuoi trigger nella pagina Trigger . Utilizzando l'icona della matita è possibile modificare le impostazioni del trigger. Utilizzando i tre punti è possibile eliminare o visualizzare l'esecuzione.
  • Un'immagine con opzione di esecuzione
    Un'immagine della pagina di esecuzione dello script dell'app Google
  • Facendo clic su chiunque se i trigger visualizzeranno i registri aggiunti nel codice.
  • Un'immagine della pagina di esecuzione dello script dell'app Google
  • Crea un nuovo foglio Google.
  • Fai clic su Estensioni e scegli Apps Script .
  • Un'immagine dell'aggiunta di App Script al foglio di Google
  • Proviamo ad attivare il nostro script dell'app dalla barra dei menu.
  • Crea un metodo onOpen()nello script dell'app, questo verrà eseguito ogni volta che viene aperto un file.
  • La seguente logica creerà un'opzione Il mio menu nella barra dei menu. Questo avrà Trigger App Script come sottomenu.
  • Il secondo parametro .addItem()è il metodo da eseguire facendo clic sul pulsante Trigger App Script sul foglio di Google.
  • Fare clic su Salva .
  • function onOpen() {
      const googleSheet = SpreadsheetApp.getUi();
      googleSheet.createMenu('My Menu')
         .addItem('Trigger App Script', 'MenuClicked') //Adds MenuClicked menu
         .addToUi();
    }
    
    //This method will be executed on clicking MenuClicked option
    function MenuClicked() {
      console.log('Trigger App script clicked.')
    }
    

  • Dopo aver aggiornato il foglio di Google, sarai in grado di vedere il menu creato da App Script.
  • Un'immagine che mostra un menu personalizzato nel foglio di Google
  • Facendo clic sull'opzione Trigger App Script verrà eseguito il metodo MenuClicked nello script dell'app.
  • I log di esecuzione possono essere visualizzati nella pagina di esecuzione.
  • Un'immagine dei log di esecuzione degli script dell'app Google
  • Crea un file HTML facendo clic sull'icona Più e scegliendo HTML.
  • Qui, ho creato un Index.html che mostra Hello World.
  • Un'immagine dell'aggiunta di un file HTML nel progetto di script dell'app Google
  • Nel Code.gsfile aggiungi un metodo doGet(e). Ad esempio, ho restituito Index.html
  • function doGet(e) {
      var htmlContent = HtmlService.createTemplateFromFile('Index');
      return htmlContent.evaluate();
    }
    

  • Per distribuire l'app, fai clic su Distribuisci e fornisci una descrizione.
  • Scegliendo Esegui come me (ID e-mail) fornirai lo stesso accesso del tuo account.
  • Scegliendo Chi ha accesso come Chiunque consentirà a chiunque di accedere all'app Web.
  • Un'immagine gif della distribuzione dello script dell'app Google
  • Facendo clic su Avanti verrà visualizzato l' URL dell'app Web tramite il quale è possibile accedere al contenuto HTML.
  • Un'immagine con l'URL di distribuzione
  • Puoi anche restituire altri tipi di dati come JSON o XML.

▹ Questo blog tratta principalmente la panoramica di base e le funzionalità dello script dell'app Google.
▹ Google App Script è pieno di molte funzioni e capacità e le combinazioni sono illimitate.
▹ Utilizzando questo, è possibile eseguire molte azioni e automazioni.