Pratica l'utilizzo di Google Apps Script: accesso a Fogli Google, Maps e Gmail in 4 righe di codice.

1. Introduzione a Google Apps Script

In questo codelab, ti presenteremo uno dei modi più semplici per scrivere codice che accede alle tecnologie per sviluppatori Google. Il tutto mediante l'applicazione di JavaScript, un tradizionale linguaggio di sviluppo web. Con Google Apps Script, scriverai il codice per estrarre un indirizzo civico da una cella di un foglio Google, genererai una mappa di Google in base all'indirizzo e poi invii la mappa come allegato utilizzando Gmail. Sai qual è la parte migliore? Contiene solo quattro righe di codice.

Obiettivi didattici

• Come utilizzare Google Apps Script con vari servizi Google, come Fogli Google, Google Maps e Gmail.
• Sviluppa il codice utilizzando l'editor interno al browser per Apps Script.

Che cosa ti serve

• Un browser web con accesso a internet
• Un Account Google (gli account Google Workspace potrebbero richiedere l'approvazione di un amministratore)
• Familiarità di base con Fogli Google
• Possibilità di leggere la notazione A1 di Fogli

2. Sondaggio

Come utilizzerai questo codelab/tutorial?

Solo lettura Leggilo e completa gli esercizi

Come giudichi la tua esperienza con gli strumenti per sviluppatori di Google Workspace e API?

Principiante Livello intermedio Eccellente

3. Panoramica

Ora che sai di cosa tratta questo codelab, cosa farai esattamente?

1. Scopri qualcosa su Apps Script, che è basato su JavaScript.
2. Crea un foglio di lavoro in Fogli Google.
3. Inserisci un indirizzo nella cella superiore sinistra (A1) del foglio di lavoro.
4. Scopri come aprire l'editor di Apps Script per qualsiasi documento.
5. Modifica il codice di Apps Script, salvalo ed eseguilo.
6. Utilizza Gmail per visualizzare il risultato.

Iniziamo.

Che cos'è Google Apps Script?

Google Apps Script è una piattaforma di sviluppo che semplifica e velocizza la creazione di script e piccole applicazioni che si integrano con Google Workspace. Con Apps Script, puoi:

• Scrivi il codice in JavaScript e accedi alle librerie integrate per le applicazioni di Google Workspace come Gmail, Calendar, Drive ecc.
• Non devi installare nulla: ti forniamo un editor di codice direttamente nel tuo browser e i tuoi script vengono eseguiti sui server di Google.
• Non devi preoccuparti di argomenti complessi come la sicurezza e le autorizzazioni di accesso ai dati, poiché la piattaforma li gestisce per te.

NOTA: le modalità di scrittura del codice JavaScript non rientrano nell'ambito di questo codelab specifico. Il nostro obiettivo è farti acquisire dimestichezza con l'ambiente di sviluppo di Apps Script e visualizzare i tipi di applicazioni che puoi utilizzarlo per creare.

Se non hai mai utilizzato JavaScript, Codecademy offre un corso introduttivo JavaScript senza costi. Questo corso non è stato realizzato da Google, ma dovrebbe coprire tutto ciò che devi sapere.

Apps Script può essere utilizzato per creare varie applicazioni, dai bot di chat alle app web. Uno degli utilizzi più comuni è l'estensione della funzionalità di un foglio di lavoro di Fogli Google. Nella parte restante di questo codelab imparerai a utilizzare Apps Script per prendere i dati da un foglio di lavoro e collegarli ad altri servizi Google.

4. Creare un foglio Google e inserisci un indirizzo

In un nuovo foglio Google, inserisci un indirizzo valido seguendo queste istruzioni:

1. Crea un foglio Google usando questo link pratico (sheets.google.com/create). In alternativa, vai su Google Drive (drive.google.com) e fai clic su Nuovo > Fogli Google > Foglio di lavoro vuoto

2. Nel foglio di lavoro vuoto, vai alla prima cella nell'angolo superiore sinistro (A1). Questo valore si trova nella colonna A e nella riga 1. Per conoscere meglio te stesso, leggi questa descrizione della notazione A1.
3. Inserisci un indirizzo valido nella cella. Scegli un indirizzo nel mondo con una posizione esatta utilizzando un indirizzo, un codice postale o una combinazione di città e stato/provincia. Ecco un esempio di indirizzo di New York:

Questo è tutto ciò che devi fare nel foglio. Apriamo l'editor e scriviamo del codice.

5. Modifica il codice di Apps Script

Ora che hai un nuovo foglio Google, è il momento di modificare lo script associato. Segui queste istruzioni:

Apri l'editor di script

Nella barra dei menu, seleziona Estensioni > Apps Script per aprire l'editor di codice del browser per Apps Script.

In una nuova scheda del browser, l'editor di codice mostra lo script predefinito vincolato al container per il foglio. Viene creata automaticamente una funzione predefinita denominata myFunction() e il cursore viene posizionato all'interno della funzione per consentirti di iniziare.

Invia una mappa Google dell'indirizzo

Il "modello" il codice ricevuto è vuoto, quindi sostituiamolo con la nostra applicazione.

1. Nell'editor di script, sostituisci il blocco di codice myFunction() predefinito con il seguente codice:

/** @OnlyCurrentDoc */
function sendMap() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var address = sheet.getRange('A1').getValue();
  var map = Maps.newStaticMap().addMarker(address);
  GmailApp.sendEmail('YOUR_EMAIL_ADDR', 'Map', 'See below.', {attachments:[map]});
}

2. Sostituisci l'indirizzo email segnaposto ('YOUR_EMAIL_ADDR') con un indirizzo valido. Ad esempio [e-mail].
3. Per salvare lo script, fai clic su Salva .
4. Per rinominare il progetto Apps Script, fai clic su Progetto senza titolo, inserisci un titolo per il progetto e fai clic su Rinomina.

Revisione del codice

Esaminiamo le 4 righe della funzione sendMap() che compongono l'intera applicazione. È interessante notare che il codice fa riferimento a tre diversi prodotti Google.

La prima riga contiene un commento relativo a un'annotazione che influisce sull'autorizzazione:

/** @OnlyCurrentDoc */

La maggior parte degli script richiede all'utente alcune autorizzazioni prima di poter essere eseguita. Queste autorizzazioni controllano ciò che l'utente consente di fare lo script. La prima riga è un commento contenente un'annotazione facoltativa che indica ad Apps Script di limitare l'accesso al foglio di lavoro corrente (anziché a tutti i fogli di lavoro dell'utente). La best practice prevede sempre di includere questa annotazione quando lavori con un solo file.

Il codice utilizza una normale dichiarazione di funzione JavaScript per sendMap():

function sendMap() {

Nella riga successiva viene chiamato il Servizio fogli di lavoro accessibile da Apps Script mediante l'oggetto SpreadsheetApp. Il foglio restituito è assegnato a una variabile con lo stesso nome. Il metodo getActiveSheet() recupera un riferimento all'oggetto del foglio corrente e lo archivia nella variabile sheet.

  var sheet = SpreadsheetApp.getActiveSheet();

Con l'oggetto sheet, facciamo riferimento all'intervallo di celle (di una singola cella) in notazione A1 con getRange(). Un "intervallo" è un gruppo di celle, tra cui una singola come la cella A1 (quella in cui abbiamo inserito l'indirizzo). Per recuperare che cosa c'è all'interno dell'intervallo, il metodo getValue() restituisce il valore della cella in alto a sinistra dell'intervallo e assegna il valore alla variabile address. Puoi anche provare ad aggiungere altri indirizzi e a leggere da celle diverse.

  var address = sheet.getRange('A1').getValue();

La terza riga di codice si collega al servizio Maps Google utilizzando l'oggetto Maps. newStaticMap() crea un oggetto mappa statico e il metodo addMarker() aggiunge un "fissa" alla mappa utilizzando l'indirizzo nel foglio.

  var map = Maps.newStaticMap().addMarker(address);

Infine, il servizio Gmail tramite l'oggetto MailApp chiama il metodo sendEmail() per inviare l'email che include sia il testo "Vedi sotto". e l'immagine della mappa come allegato.

  GmailApp.sendEmail('[e-mail]', 'Map', 'See below.', {attachments:[map]});
}

6. Eseguire le app Fogli Google, Maps e Gmail

Dopo aver assegnato il nome e salvato, è il momento di eseguire la funzione. Nella parte superiore dell'editor, assicurati che sendMap() sia selezionato dall'elenco delle funzioni e fai clic su Esegui.

Una funzionalità di Apps Script apprezzata dagli sviluppatori è che non devi scrivere codice di autorizzazione che conceda al programma l'accesso ai dati dell'utente. Anche se Apps Script gestisce questa opzione, gli utenti della tua app devono comunque concedere allo script l'autorizzazione ad accedere ai propri fogli di lavoro e a inviare email tramite Gmail. La prima finestra di dialogo di autorizzazione ha il seguente aspetto:

Fai clic su Rivedi autorizzazioni per continuare.

Nota:se utilizzi un account gmail.com, potresti visualizzare il messaggio "Questa app non è stata verificata". quando usi lo script per la prima volta. Google utilizza questo metodo per avvisare gli utenti che potrebbero utilizzare codice di autori sconosciuti o non attendibili. Se viene visualizzata questa finestra di dialogo, puoi procedere poiché sei l'autore dello script. Segui le istruzioni sullo schermo per continuare ad autorizzare lo script:

1. Nella finestra di dialogo dell'app non verificata, fai clic su Avanzate.
2. Fai clic su Vai a nome-progetto (non sicuro).
3. Fai clic su Consenti.

Durante questo codelab potresti ricevere diversi prompt di autorizzazione. Per ulteriori informazioni su questa procedura, consulta la pagina Autorizzazione per i servizi Google.

Verrà visualizzata la finestra di dialogo OAuth2 in cui ti viene chiesta l'autorizzazione ad accedere al foglio e a inviare email per tuo conto:

Dopo aver concesso l'autorizzazione, lo script viene eseguito fino al completamento.

Controlla l'account email a cui hai inviato il messaggio. Dovresti trovare un'email con la dicitura "Mappa". come oggetto e un messaggio simile al seguente:

Quando apri l'allegato nel messaggio email, dovresti visualizzare una mappa di Google con un segnaposto con l'indirizzo inserito nel foglio:

Con solo quattro righe di codice hai avuto accesso a 3 diversi prodotti Google in modo significativo.

7. Risorse aggiuntive

Il codice incluso in questo codelab è disponibile anche nel relativo repository GitHub all'indirizzo github.com/googleworkspace/apps-script-intro-codelab. Di seguito puoi trovare altre risorse per approfondire il materiale trattato in questo codelab e per esplorare altri modi di accedere agli strumenti per sviluppatori di Google in modo programmatico.

Documentazione

• Sito di documentazione di Google Apps Script
• Apps Script: servizio Gmail
• Apps Script: servizio fogli di lavoro
• Apps Script: servizio Maps

Video

• Assolutamente spontaneo
• Google Workspace Developer Show

Notizie e aggiornamenti

• Blog per gli sviluppatori di Google Workspace
• Twitter: Sviluppatori di Google Workspace (@workspacedevs)

Altri codelab

Introduttivo

• [Fogli Google] Concetti fondamentali di Apps Script con Fogli Google
• [API REST] Utilizzare Google Workspace e le API di Google per accedere a file e cartelle su Google Drive

Intermedio

• [Apps Script] Componenti aggiuntivi di Google Workspace per Gmail
• [Apps Script] Bot personalizzati per Hangouts Chat
• [API REST] Usa Fogli Google come strumento di reporting per la tua applicazione
• [API REST] Generare presentazioni Google utilizzando l'API BigQuery

Applicazioni di riferimento

• Generare Presentazioni Google da Markdown e HTML utilizzando l'API Presentazioni