Importare grafici da Spreadsheet a Document con Google Apps Script

La funzione proposta in questo articolo è un valido esempio di come con Google Apps Script sia semplice far comunicare tra loro strumenti diversi della G Suite.

Nel caso specifico, è mostrato come sia possibile, con uno script autonomo di sole 5 righe, recuperare i grafici presenti in un foglio di Google Sheets ed importarli in un Google Docs.

Il codice in questione è il seguente:

function importChart() {
  var charts =  SpreadsheetApp.openById('ID_SPREADSHEET').getSheetByName('NOME_FOGLIO').getCharts();
  var doc = DocumentApp.openById('ID_DOCUMENT');
  for (var i in charts) {
    doc.getBody().appendImage(charts[i]);
    Logger.log(charts[i].getBlob().getName());
  }
}

I valori da modificare in base alla propria situazione sono i seguenti:

ID_SPREADSHEET: l'identificativo univoco del file Google Sheets
NOME_FOGLIO: il nome del foglio del Google Sheets dove sono contenuti i grafici da recuperare
ID_DOCUMENT: il Google Docs di destinazione dove i grafici devono essere importati

L'immagine seguente rappresenta un esempio di grafici contenuti in un Foglio Google, Fig. 1:

Fig. 1 - Grafici in un Google Sheets

Dopo l'esecuzione della funzione personalizzata, chiamata nel caso dell'esempio importChart(), è possibile trovare nel Documento Google la seguente situazione. Fig. 2:

Fig. 2 - Grafici importati da un Google Sheets ad un Google Docs

In termini di tempo di esecuzione, al fine di una valutazione dal punto di vista delle prestazioni, il completamento dell'operazione, nel caso specifico, è stato di circa 5 secondi.