Just A Little Bit Of Geekness

Creiamo uno script per non dimenticarci dei compleanni importanti

2018-02-12T09:30:00.000+01:00

Oggi voglio sospendere temporaneamente la panoramica sugli Apps Script e iniziare con voi un piccolo progetto. Avevo in mente un Google Apps Script che giornalmente invitasse una email con il riepilogo dei compleanni odierni dei propri contatti e quelli dei prossimi 7 giorni in modo da potersi ricordare per tempo un eventuale regalo.

Procediamo a creare il nostro script come abbiamo imparato a fare in precedenza.

Google riversa automaticamente (prendendoli dai nostri contatti) i compleanni, e altri eventi, in un calendario speciale. Dovremmo quindi puntare questo calendario per recuperarli.

Ci tengo a precisare che per ottenere il riferimento a un calendario ci sono 3 diversi metodi della classe CalendarApp:

getDefaultCalendar() restituisce il calendario di default quindi non servono parametri e otteniamo un unico calendario
getCalendarsByName(name) restituisce un array di calendari, di proprietà dell'utente o a lui accessibili, il cui nome combacia con la stringa passata come parametro.
getCalendarById(id) restituisce il calendario che risponde a uno specifico id (i vari id dei calendari a cui avete accesso li trovate ovviamente in Google Calendar, nelle impostazioni dello specifico calendario)

In questo caso andremo ad usare il terzo metodo visto che l'id del calendario dei contatti è univoco per tutti: #contacts@group.v.calendar.google.com

In questo progetto useremo 3 file diversi. Oltre a Codice.gs, presente di default in ogni nuovo progetto, dovremmo creare due file HTML (Email.html e Stylesheet.html), dal menù File -> Nuovo -> File HTML

In Codice.gs ci saranno tutte le funzioni che verranno utilizzate nel nostro progetto, in caso di progetti più complessi si potrà suddividerle in più file che dovranno avere estensione .gs
In Stylesheet.html ci sarà il tag <style> con tutto il CSS necessario a dare uno stile alla nostra mail (Gmail supporta i CSS).

In Email.html ci sarà il template che, a partire dai dati recuperati da una funzione, genererà l'HTML che verrà inviato via mail.

Come potrete vedere non mi sono impegnato molto per creare un HTML particolarmente accattivante ma ho cercato di fare del mio meglio per documentare chiaramente il codice.

Di seguito il codice commentato di tutti e 3 i file.

Il progetto nella sua interezza è su Github, la versione relativa a questo articolo è qui ma se voleste contribuire a migliorarlo o semplicemente andare a vedere l'ultima versione disponibile allora recatevi subito qui. Ovviamente qualsiasi contributo all'html e ai css sarà il benvenuto.

Come potrete intuire al momento dovrete configurare manualmente l'esecuzione automatica dello script come avevamo già visto qui. Io vi consiglio di metterlo giornaliero ma se volete potrete modificare velocemente il codice per eseguire lo script una volta a settimana, recuperare gli eventi dei successivi 30 giorni, mostrare i compleanni della settimana in primo piano e i restanti in coda.

Nei prossimi articoli vorrei illustrarvi come scrivere agevolmente il codice offline e caricarlo velocemente (in modo da poter usare strumenti di versioning come git e in modo da poter caricare con più comodità i miei futuri progetti), vorrei trattare la creazione programmatica dei trigger e migliorare questo progetto inserendo anche un modo per filtrare i contatti per cui ricevere il promemoria. Se avete preferenze fatemi sapere.

Esecuzione automatica di un Google Apps Script

2018-02-05T09:32:00.000+01:00

Progetto

Creiamo un nuovo script per loggare il livello di spam nella nostra casella di posta.
Poniamo di essere degli individui meticolosi che controllano periodicamente lo spam alla ricerca di falsi positivi per evitare che una mail importante vada persa come lacrime nella pioggia (cit.)
Per far ciò, ogni volta che vediamo aumentare il contatore delle mail non lette sotto l'etichetta "spam", andremo a controllare se queste mail siano effettivamente spam o meno e se sono spam li elimineremo definitivamente.

Script

Creiamo quindi un progetto "Spam Monitor" e scriviamo al suo interno questa funzione
La funzione in se è molto semplice, recupera il numero di discussioni non lette in spam, crea un oggetto con un messaggio e il contatore stesso, successivamente logga questo oggetto come "info" se il contatore è a zero, "warning" se è compreso tra 0 e 5 e "error" se è maggiore o uguale a 5.
Ovviamente alla sua prima esecuzione ci troveremo a dover autorizzare lo script come abbiamo visto nel precedente articolo.

Log filtering

Potremo poi consultare i log su stackdriver, avere a colpo d'occhio i messaggi in ordine cronologico e potremo anche filtrarli. Per esempio potremo usare un filtro avanzato per estrarre solo i log con unreadSpam maggiore di 0 e minore di 3 con un filtro avanzato come questo
jsonPayload.unreadSpam>0 AND
jsonPayload.unreadSpam<3 font="">
oppure consultare solo i warning e gli error con questo filtro avanzato
severity="WARNING" OR
severity="ERROR"

Ovviamente Stackdriver ha una quantità incredibile di funzionalità che ci permettono di consultare i log come può venirci più comodo ma adesso abbiamo il problema di come generarli in maniera costante. Per esempio sarebbe comodo se il nostro script potesse essere eseguito periodicamente, magari una volta ogni ora in modo da generare dei dati costanti da poter analizzare con calma.

Trigger

Il metodo più veloce è di creare un trigger manuale dal menù "Modifica" selezionando la voce "Trigger del progetto corrente"

Nella modale che si apre aggiungere un trigger per la nostra funzione che venga eseguito ogni ora. Per sicurezza dal link "notifiche" andiamo a impostare che ci venga inviata una mail appena si presenta un errore con l'esecuzione di questo trigger.

Conclusione

Oggi abbiamo fatto una panoramica sulla gestione dei log e sui trigger. Anche in questo caso si tratta di argomenti molto vasti che andranno ripresi più avanti per essere trattati in maniera adeguata. Questo ovviamente è ancora un articolo introduttivo e ritengo sarebbe prematuro buttarsi subito ad approfondire ogni singolo argomento prima ancora di aver dato la possibilità di capire se i Google Apps Script possano essere quello che fa al proprio caso.

Il nostro primo Google Apps Script

2018-02-04T16:52:00.004+01:00

Divertiamoci

Spolverate le tastiere e regolate la luminosità dei monitor, oggi si inizia a giocare con i Google Apps Script (per brevità GAS).

Riprendiamo da dove abbiamo lasciato l'ultima volta e creiamo un nuovo script standalone.

Per prima cosa diamo subito un nome al progetto e facciamo si che sia qualcosa di significati, insomma qualcosa tipo "test" o "foo bar" andrà benissimo. Spostiamoci nella parte riservata all'editor e iniziamo a scrivere del codice.

Autorizzazione

Provando ad eseguirla noterete dei popup con richieste di autorizzazione (non è che si possa accedere a Gmail senza un esplicito permesso per motivi di sicurezza).

Anche se lo script sarà solo a nostro uso e consumo Google non vuole certo lesinare sulla sicurezza e ci tiene a specificare quando qualcosa non è sicuro al 100%

In un prossimo articolo tratterò la procedura di verifica ma per adesso vi basti sapere che dovete fare click su "Avanzate" e successivamente su "Apri [nome progetto] (non sicura)", a questo punto è quasi finita l'odissea e ci vengono presentate le autorizzazione richieste e dobbiamo acconsentire per poter finalmente usare lo script.

Fortunatamente questa procedura ci verra riproposta solo nel caso in cui si vada a modificare lo script e siano necessarie altre autorizzazione (es. per calendar). Google invia anche una mail all'account che ha autorizzato lo script e, in ogni momento, si può rimuovere l'autorizzazione da qui.

Logging

Fino a poco tempo fa avrei dovuto mettervi in guardia sul non usare assolutamente l'oggetto console per loggare ma Google ha integrato il suo strumento di log Stackdriver rendendo possibile salvare gratuitamente i log degli ultimi 7 giorni (a pagamento il limite si estende a 30 giorni) tramite i classici comandi console.log .info .error eccetera.

La differenza tra le due modalità è che tramite Logger i log non persistono a lungo, sono la modalità storica di log per Apps Script e sono indicati principalmente durante la fase di sviluppo e dubug mentre Stackdriver è uno strumento molto più potente e versatile, permette la ricerca tra i log, la creazione di metriche e molto altro ma quando si sta sviluppando qualcosa di nuovo è molto più veloce e pratico limitarsi al sistema di logging nativo. Potete ovviamente sostituire Logger.log con console.log e avere subito un'idea di quello che potete vedere in Stackdriver. Dal menù "Visualizza" potete scegliere se visualizzare il log nativo "Log" o "Stackdriver Logging" e noterete che potrete consultare anche gli errori salvati in "Stackdriver Error Reporting".

Conclusione

Con questo articolo abbiamo scritto la nostra prima funzione, ci siamo imbattuti nelle richieste di autorizzazione e abbiamo scoperto l'esistenza dei diversi metodi di logging. Ovviamente tutti questi argomenti andranno trattati in maniera molto più approfondita meritandosi almeno un articolo a testa. Per il momento spero di aver iniziato a mettervi un po' di curiosità e che vogliate iniziare a sperimentare in autonomia. Ci si vede al prossimo articolo con una panoramica su altri argomenti sperando di spingervi ad avvicinarvi sempre di più a questa incredibile tecnologia.

Come al solito se avete dubbi, curiosità o richieste non siate timidi e fate sentire la vostra voce.