/ / Come potenziare Google Apps con Script Editor

Come potenziare Google Apps con Script Editor

Google Apps Script Lede

Se usi Google Apps, è probabile che tu lo sianon usarli al massimo. Con Google Apps Script puoi aggiungere menu e finestre di dialogo personalizzati, scrivere funzioni e macro personalizzate e creare componenti aggiuntivi per estendere documenti, fogli e diapositive di Google.

Che cos'è lo script di Google Apps?

Google Apps Script è uno sviluppo basato su cloudpiattaforma per la creazione di applicazioni Web personalizzate e leggere. Puoi creare applicazioni scalabili direttamente all'interno del tuo browser che si integrano facilmente con i prodotti Google.

Apps Script utilizza il linguaggio JavaScript eriunisce la familiarità dello sviluppo web e dei prodotti Google in un unico posto, rendendolo uno strumento perfetto per personalizzare le app per la tua azienda, organizzazione o semplicemente per automatizzare attività banali.

Puoi creare due tipi di script con Google Apps Script:

  • Indipendente, autonomo: Questi script non sono associati a nessun servizio, ad esempioGoogle Documenti, Fogli o Presentazioni. Possono eseguire funzioni a livello di sistema, un po 'come macro. Non sono ideali per la condivisione con un pubblico più ampio perché è necessario copiare e incollare il codice per usarli. Gli esempi includono la ricerca in Drive di file con nomi specifici o la visualizzazione di chi ha accesso ai file e alle cartelle condivisi in Drive.
  • Limite: Questi sono collegati a documenti, fogli, moduli di Google,o il file delle diapositive. Gli script associati estendono la funzionalità di un file ed eseguono azioni solo in quel file specifico. Gli esempi includono l'aggiunta di menu personalizzati, finestre di dialogo e barre laterali a un servizio o uno script che ti invia notifiche via e-mail ogni volta che una determinata cella in un foglio cambia.

Se non conosci molto JavaScript, o forsenon ne hai mai sentito parlare prima, non lasciarti spaventare dallo sviluppo di una tua sceneggiatura. È semplicissimo iniziare a utilizzare Apps Script, in quanto fornisce una vasta gamma di documentazione ed esempi da provare da soli. Di seguito sono riportati un paio di semplici esempi per aiutarti a comprendere come funzionano.

Come creare uno script autonomo

Ora che sai cosa sono, andiamo avantie crea il tuo primo script autonomo. Utilizzeremo un esempio di codice di Google per aiutarci a far rotolare la palla e forniremo spiegazioni alle righe di codice se non hai familiarità con GoogleScript o JavaScript.

Vai su a Google Apps Script. Nell'angolo in alto a sinistra, fai clic sull'icona dell'hamburger, quindi fai clic su "Nuovo script".

Un nuovo progetto senza titolo si apre con una funzione vuota all'interno, ma poiché stiamo utilizzando il codice di esempio di Google, puoi andare avanti ed eliminare tutto il testo nel file.

La tua primissima funzione Script per app

Nota: Devi aver eseguito l'accesso al tuo account Google per far funzionare questo script.

Dopo aver eliminato il codice precaricato nel file, incollare il seguente codice:

//Initialize your function
function createADocument() {
// Create a new Google Doc named 'Hello, world!'
var doc = DocumentApp.create('Hello, world!');
// Access the body of the document, then add a paragraph.
doc.getBody().appendParagraph('This document was created by Google Apps Script.');
}

Prima di poter eseguire il codice, è necessario salvare lo script. Fai clic su "File", quindi su "Salva".

fai clic su File, quindi fai clic su Salva per salvare lo script

Rinomina il progetto in qualcosa che ti aiuti a ricordare cosa fa lo script, quindi premi "OK".

Rinomina il tuo progetto in qualcosa che ti dice cosa fa lo script, quindi fai clic su OK

Per eseguire il codice, fai clic sull'icona di riproduzione situata nella barra degli strumenti.

Fai clic sull'icona Esegui

Dovrai concedere allo script alcune autorizzazioni per accedere al tuo account Google tramite una finestra popup dopo aver fatto clic su "Esegui" per la prima volta. Fai clic su "Rivedi autorizzazioni" per vedere a cosa deve accedere.

Prima di poter eseguire lo script, è necessario rivedere le autorizzazioni necessarie. Fai clic su Revisiona autorizzazioni

Perché questa non è un'app verificata da Google, turiceverà un altro avvertimento. In pratica dice che, a meno che tu non sappia che lo sviluppatore (noi) procede solo se ti fidi di loro. Fai clic su "Avanzate", quindi fai clic su "Vai a CreateNewDoc" (o come hai chiamato questo script).

Viene visualizzato un avviso di Google che indica che l'app in esecuzione non è stata verificata da loro. Fai clic su Avanzate, quindi fai clic su Vai a CreateNewDoc

Controlla le autorizzazioni richieste dallo script, quindi fai clic su "Consenti".

Rivedere le autorizzazioni, quindi fare clic su Consenti

Grande! Ora, vai sul tuo Drive e se tutto ha funzionato, il file "Hello, World!" Dovrebbe essere lì. Fare doppio clic per aprirlo.

Passa al tuo Drive e fai doppio clic sul file appena creato

Quando apri il file, vedrai la riga di testo del codice aggiunta al documento.

All'interno del file è presente la riga di testo aggiunta tramite lo script

Ora, se vuoi ricevere una notifica via e-mail quando il documento viene creato, puoi aggiungere qualche altra riga di codice per inviarne una automaticamente al tuo account Google. Aggiungi le seguenti righe di codice dopo doc.getBody().appendParagraph('This document was created by Google Apps Script.'); ma prima dell'ultima parentesi graffa } :

// Get the URL of the document.
var url = doc.getUrl();
// Get the email address of the active user - that's you.
var email = Session.getActiveUser().getEmail();
// Get the name of the document to use as an email subject line.
var subject = doc.getName();
// Append a new string to the "url" variable to use as an email body.
var body = 'Link to your doc: ' + url;
// Send yourself an email with a link to the document.
GmailApp.sendEmail(email, subject, body);

Fai clic sull'icona "Esegui".

Fai clic sull'icona Esegui

Poiché hai aggiunto un paio di righe extra che richiedono autorizzazioni aggiuntive, devi seguire lo stesso processo di prima. Fai clic su "Rivedi autorizzazioni".

Prima di poter eseguire lo script, è necessario rivedere le autorizzazioni necessarie. Fai clic su Revisiona autorizzazioni

Fai clic su "Avanzate", quindi fai clic su "Vai a CreateNewDoc".

Nota: Come Google ti sta avvisando del lancioapp non verificate, riceverai anche un'email di avviso di sicurezza che ti avviserà. Google lo fa nel caso in cui non fossi tu a garantire l'accesso a un'applicazione non verificata.

Esamina il nuovo set di autorizzazioni richiesto dallo script, quindi fai clic su "Consenti".

Rivedi la nuova autorizzazione e fai clic su Consenti

Quando il documento viene creato, ricevi un'email con un link al file nel tuo Google Drive.

La notifica e-mail che viene inviata automaticamente dallo script contiene un collegamento al nuovo documento

Facendo clic sul collegamento si accede direttamente al file, che si trova all'interno di Google Drive.

All'interno del file è presente la riga di testo aggiunta dallo script

Come creare uno script associato

Per il prossimo esempio, creiamo uno script associato per Fogli Google che analizza un foglio esistente per voci duplicate in una riga e quindi le elimina.

Se ricordi da prima, gli script associati funzionano come un componente aggiuntivo per file specifici, quindi per crearne uno, apriamo un foglio di calcolo di Google Sheet esistente che contiene almeno un punto dati duplicato.

Un foglio di Google con righe duplicate

Fai clic su "Strumenti", quindi fai clic su "Script Editor".

Fai clic su Strumenti, quindi fai clic su Script Editor

Lo script di Google Apps si apre in una nuova scheda con uno script vuoto. Questa volta, tuttavia, lo script è associato al foglio da cui si apre.

Una funzione vuota per lo script associato

Proprio come prima, elimina la funzione vuota e incolla il seguente codice:

//Removes duplicate rows from the current sheet.
function removeDuplicates() {
//Get current active Spreadsheet
var sheet = SpreadsheetApp.getActiveSheet();
//Get all values from the spreadsheet's rows
var data = sheet.getDataRange().getValues();
//Create an array for non-duplicates
var newData = [];
//Iterate through a row's cells
for (var i in data) {
var row = data[i];
var duplicate = false;
for (var j in newData) {
if (row.join() == newData[j].join()) {
duplicate = true;
}
}
//If not a duplicate, put in newData array
if (!duplicate) {
newData.push(row);
}
}
//Delete the old Sheet and insert the newData array
sheet.clearContents();
sheet.getRange(1, 1, newData.length, newData[0].length).setValues(newData);
}

Nota: Affinché lo script rimuova un duplicato, tutte le celle della riga devono corrispondere.

Salvare e rinominare lo script, quindi premere l'icona "Esegui".

Fai clic sull'icona Esegui

Ancora una volta, come hai incontrato nell'ultima sceneggiaturacreato, dovrai rivedere le autorizzazioni richieste dallo script e concedergli l'accesso al foglio di lavoro. Fai clic su "Rivedi autorizzazioni" per vedere quale accesso desidera questo script.

Fare clic su Rivedi autorizzazioni per visualizzare le autorizzazioni richieste

Accetta le istruzioni e fai clic su "Consenti" per autorizzare lo script.

Rivedere le autorizzazioni, quindi fare clic su Consenti

Al termine dell'esecuzione, torna al tuo foglio e, proprio come per magia, tutte le voci duplicate scompaiono dal tuo file!

I punti dati duplicati sono stati rimossi!

Sfortunatamente, se i tuoi dati sono all'interno di una tabella - come nell'esempio sopra - questo script non ridimensionerà la tabella per adattarla al numero di voci in essa contenute.


Anche se questi sono due piuttosto sempliciesempi su come usare Apps Script, le opzioni sono quasi illimitate e tutto dipende da cosa puoi immaginare con queste risorse. Ma, nel frattempo, vai alla pagina GSuite Devs Github o Digital Inspiration e controlla la pila di script di esempio che puoi distribuire all'interno dei tuoi servizi per avere un'idea migliore di ciò che Apps Script è veramente in grado di fare.