Concetti fondamentali di Apps Script con Fogli Google 5: grafici e presentazione di dati in Presentazioni

1. Introduzione

Ti diamo il benvenuto nella quinta parte della playlist del codelab di Fundamentals of Apps Script with Fogli Google. Questo codelab ti spiega come utilizzare il servizio di foglio di lavoro in Apps Script per registrare un set di dati. Vorrai anche imparare a utilizzare il servizio Presentazioni per esportare il grafico in una nuova presentazione in Presentazioni Google.

Obiettivi didattici

• Come creare un grafico a linee con Apps Script.
• Come esportare i grafici in una nuova presentazione di Presentazioni.
• Come presentare le finestre di dialogo all'utente in Fogli.

Nota: in questo codelab, lavorerai principalmente con il servizio Apps Script Spreadsheet per creare e manipolare grafici incorporati.

Apps Script dispone anche di un servizio Classifiche dedicato. Tuttavia, è principalmente destinato alla creazione e alla modifica di grafici da utilizzare in applicazioni esterne a Fogli Google. Questo codelab non coprirà questi casi d'uso.

Prima di iniziare

Questo è il quinto codelab della playlist Concetti fondamentali dello script con Fogli Google. Prima di iniziare questo codelab, assicurati di completare i codelab precedenti:

1. Macro e funzioni personalizzate
2. Fogli di lavoro, Fogli e intervalli
3. Utilizzo dei dati
4. Formattazione dei dati

Che cosa ti serve

• Comprensione degli argomenti di base di Apps Script esplorati nei precedenti codelab di questa playlist.
• Familiarità con l'editor di Apps Script
• Familiarità con Fogli Google
• Possibilità di leggere la notazione A1 di Fogli
• Familiarità con JavaScript e la relativa classe String

2. Configura

Prima di continuare, ti servirà un foglio di lavoro con alcuni dati. Come in precedenza, ti abbiamo fornito un foglio dati che puoi copiare per questi allenamenti. Segui questi passaggi:

1. Fai clic su questo link per copiare il foglio dati, quindi fai clic su Crea una copia. Il nuovo foglio di lavoro viene inserito nella cartella di Google Drive e denominato "Copia di date e tassi di cambio".
2. Fai clic sul titolo del foglio di lavoro e modificalo da "Copia di date e tassi di cambio USD" a "Date e tassi di cambio USD". Il foglio deve avere questo aspetto, con alcune informazioni di base su tassi di cambio diversi per le valute statunitensi in date diverse:

3. Per aprire l'editor di script, fai clic su Estensioni> Apps Script.

Per farti risparmiare tempo, abbiamo incluso un piccolo codice per impostare un menu personalizzato in questo foglio di lavoro. Potresti aver visualizzato il menu quando la copia del foglio di lavoro è stata aperta:

Nota: per ulteriori informazioni sui menu personalizzati e su onOpen(), consulta il codelab su Utilizzo dei dati.

Punto chiave:dal momento che il foglio di lavoro che hai copiato ha un progetto di script associato, il foglio di lavoro lo è anche il progetto dello script. Tieni presente che si tratta di una copia del progetto di script originale, le modifiche apportate alla copia non verranno applicate nell'originale e viceversa.

Con questo foglio di lavoro e progetto, puoi iniziare il codelab. Passa alla sezione successiva per iniziare a scoprire grafici e attivatori basati sul tempo.

3. Creare un grafico in Fogli con Apps Script

Supponi di voler progettare un grafico specifico per visualizzare un set di dati. Puoi utilizzare Apps Script per creare, modificare e inserire grafici in Fogli Google. Quando un grafico contiene un foglio di lavoro, viene chiamato grafico incorporato.

I grafici vengono utilizzati per visualizzare una o più serie di dati. Di solito, i dati incorporati provengono dai grafici incorporati. In genere, l'aggiornamento dei dati nel foglio di lavoro fa sì che Fogli aggiorni automaticamente anche il grafico.

Puoi utilizzare Apps Script per creare da zero grafici incorporati personalizzati o per aggiornare grafici esistenti. Questa sezione illustra le nozioni di base sulla creazione di grafici incorporati in Fogli con Apps Script e nel servizio Spreadsheet.

Suggerimento: sebbene sia possibile utilizzare Apps Script per eseguire più attività con i grafici, ci sono alcune azioni che non è possibile eseguire. Il servizio Foglio di lavoro fornisce diverse classi EmbeddedChart che offrono la funzionalità di creazione di grafici, ma non coprono tutte le possibili opzioni di configurazione. Inoltre, Apps Script utilizza anche l'API Google Graph, che ha le proprie limitazioni.

A causa di questi limiti, è spesso utile usare Apps Script per creare grafici di base o per modificare in primo luogo la formattazione e poi perfezionarla manualmente in Fogli. Potresti non essere in grado di automatizzare tutte le procedure relative ai grafici in Apps Script, ma puoi farlo nella maggior parte dei casi.

Implementazione

Nella copia del foglio di lavoro, il set di dati "Date e tassi di cambio" mostra i tassi di cambio (per 1 dollaro statunitense) di valute diverse in date diverse. Implementerai una funzione Apps Script che rende visibile un grafico per visualizzare parte di questi dati.

Segui questi passaggi:

1. Nell'editor Apps Script, aggiungi la seguente funzione alla fine dello script Code.gs del progetto di script, dopo la funzione onOpen():

/**
 * Creates and inserts an embedded
 * line chart into the active sheet.
 */
function createEmbeddedLineChart() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartDataRange = sheet.getRange(
    'Dates and USD Exchange Rates dataset!A2:F102');
  var hAxisOptions = {
    slantedText: true,
    slantedTextAngle: 60,
    gridlines: {
      count: 12
    }
  };
  
  var lineChartBuilder = sheet.newChart().asLineChart();
  var chart = lineChartBuilder
    .addRange(chartDataRange)
    .setPosition(5, 8, 0, 0)
    .setTitle('USD Exchange rates')
    .setNumHeaders(1)
    .setLegendPosition(Charts.Position.RIGHT)
    .setOption('hAxis', hAxisOptions)
    .setOption("useFirstColumnAsDomain", true)
    .build();
 
  sheet.insertChart(chart);  
}

2. Salva il progetto di script.

Revisione del codice

Il codice che hai aggiunto implementa la funzione chiamata dalla voce di menu Grafico "Date e Tassi di cambio USD" per creare un grafico a linee di base. Esaminiamo il codice.

Le prime righe determinano le seguenti tre variabili:

• sheet: un riferimento al foglio attivo corrente.
• chartDataRange: l'intervallo di dati da visualizzare. Il codice utilizza la notazione A1 per specificare l'intervallo che copre le celle da A2 a F102 nel foglio denominato Set di dati di date e tassi di cambio USD. Denominando specificamente il foglio, ci assicuriamo che la voce del menu funzioni anche se è attivo un altro foglio dato che l'intervallo copre sempre la posizione dei dati. A partire dalla riga 2, vengono incluse le intestazioni di colonna e verranno tracciate solo le 100 date più recenti (righe).
• hAxisOptions: un oggetto JavaScript di base che include alcune informazioni sull'impostazione utilizzate dal codice per configurare l'aspetto dell'asse orizzontale. In particolare, imposta le etichette di testo dell'asse orizzontale con un'angolazione di 60 gradi e imposta il numero di linee della griglia verticali su 12.

La riga successiva crea un oggetto generatore di grafici a linee. I grafici incorporati in Apps Script vengono creati utilizzando un motivo di progettazione build. Una spiegazione completa di questo pattern di progettazione è fuori ambito per questo codelab, quindi per ora ti basterà capire che il servizio Spreadsheet offre diverse classi EmbeddedChartBuilder. Per creare un grafico, il tuo codice crea innanzitutto un oggetto generatore di grafici incorporati, utilizza i suoi metodi per definire le impostazioni del grafico e poi chiama un metodo build() per creare l'oggetto finale EmbeddedChart. Il tuo codice non modifica mai direttamente l'oggetto EmbeddedChart, in quanto tutta la configurazione del grafico viene gestita attraverso le classi del builder.

Il servizio Fogli di lavoro fornisce una classe EmbeddedChartBuilder principale e più classi per la creazione di elementi secondari (ad esempio, EmbeddedLineChartBuilder) che ereditano il livello. Le classi secondarie consentono ad Apps Script di fornire i metodi di configurazione dei grafici dei builder applicabili solo a determinati tipi di grafici. Ad esempio, la classe EmbeddedPieChartBuilder fornisce un metodo set3D() applicabile solo ai grafici a torta.

Nel codice, questa riga crea la variabile dell'oggetto builder lineChartBuilder:

var lineChartBuilder = sheet.newChart().asLineChart();

Il codice chiama il metodo Sheet.newChart() per creare un oggetto EmbeddedChartBuilder, quindi utilizza EmbeddedChartBuilder.asLineChart() per impostare il tipo di builder su EmbeddedLineChartBuilder.

Il codice quindi crea il grafico utilizzando lineChartBuilder. Questa parte del codice è composta solo da una serie di chiamate di metodo per definire le impostazioni del grafico, seguite da una chiamata build() per creare il grafico. Come hai visto nei codelab precedenti, il codice utilizza il concatenamento dei metodi per mantenere il codice leggibile. Ecco come funzionano le chiamate metodologie:

• addRange(range): definisce l'intervallo di dati visualizzato nel grafico.
• setPosition(anchorRowPos, anchorColPos, offsetX, offsetY): determina dove viene posizionato il grafico nel foglio. Qui, il codice inserisce l'angolo in alto a sinistra del grafico nella cella H5.
• setTitle(title): consente di impostare il titolo del grafico.
• setNumHeaders(headers): determina quante righe o colonne nell'intervallo di dati devono essere considerate come intestazioni. In questo caso, il codice utilizza la prima riga dell'intervallo di dati come intestazioni, ovvero il testo della riga viene utilizzato come etichetta per le singole serie di dati nel grafico.
• setLegendPosition(position): sposta la legenda del grafico sul lato destro del grafico. Questo metodo utilizza l'enumerazione di Charts.Position come parametro.
• setOption(option, value): imposta opzioni complesse per i grafici. In questo caso il codice imposta l'opzione hAxis sull'oggetto hAxisOptions. Esistono diverse opzioni che puoi impostare utilizzando questo metodo. Le opzioni e i valori possibili per ogni tipo di grafico sono documentati nella Galleria grafici dell'API Charts. Ad esempio, le opzioni che puoi impostare per i grafici a linee sono documentate nella sezione Opzioni di configurazione del grafico a linee. Il metodo setOption(option, value) è un argomento avanzato, quindi ti consigliamo di evitare di utilizzarlo fino a quando non sarai più a tuo agio con la creazione del grafico in Apps Script.
• build(): crea e restituisce un oggetto EmbeddedChart utilizzando le impostazioni riportate sopra.

Infine, il codice chiama Sheet.insertChart(chart) per inserire il grafico creato nel foglio attivo.

Risultati

Per visualizzare la funzione di formattazione in azione, procedi nel seguente modo:

1. Se non l'hai ancora fatto, salva il progetto script nell'editor Apps Script.
2. Fai clic sulla voce di menu Presenta set di dati > Grafico "Date e Tassi di cambio USD". Voce di menu.

Nota: se utilizzi un account gmail.com, potrebbe essere visualizzata la finestra di dialogo "Non è verificato" quando usi per la prima volta lo script. Google lo utilizza per avvisare gli utenti che potrebbero utilizzare il codice di autori sconosciuti o non attendibili. Se vedi 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 Date e Tassi di cambio (non sicuri).
3. Fai clic su Consenti.

Durante questo codelab, potresti ricevere diverse richieste di autorizzazione. Puoi trovare ulteriori informazioni su questa procedura in Autorizzazione per i servizi Google.

Lo script ora posiziona un nuovo grafico a destra dei dati:

Congratulazioni, hai creato un grafico a linee incorporato con Apps Script. La sezione seguente spiega come esportare il grafico in Presentazioni Google.

4. Esportare i grafici in Presentazioni

Uno dei principali punti di forza di Apps Script è che ti consente di spostare facilmente i dati da un'applicazione Google Workspace a un'altra. La maggior parte di queste applicazioni dispone di un servizio Apps Script dedicato, simile al servizio Fogli di lavoro. Ad esempio, Gmail ha il servizio Gmail, Documenti Google il servizio Documento e Presentazioni Google è il servizio Presentazioni. Con tutti questi servizi integrati, puoi estrarre i dati da un'applicazione, elaborarli e scrivere il risultato.

In questa sezione imparerai come esportare ogni grafico incorporato in un foglio di lavoro Google in una nuova presentazione Google. Vedrai anche due modi per mostrare i messaggi personalizzati degli utenti in Fogli.

Nota: quando utilizzi il servizio Presentazioni, gli script possono creare oggetti Presentation e riempirli con Slides e Layouts, quindi aggiungi PageElements come Shapes, TextRanges e Lines. Per quanto riguarda le opzioni, la dimensione del servizio Presentazioni è pari a quella del foglio di lavoro.

C'è molto da fare Apps Script con Presentazioni, ma per questo codelab creerai una presentazione, creerai diapositive e importerai grafici in diapositive. Per saperne di più, consulta la documentazione relativa all'estensione di Presentazioni Google.

Implementazione

Qui implementerai la funzione chiamata dalla voce di menu Presenta set di dati > Esporta i grafici in Presentazioni. Segui questi passaggi:

1. Nell'editor Apps Script, aggiungi la seguente funzione alla fine dello script Code.gs del progetto di script, dopo la funzione createEmbeddedLineChart():

/**
 * Create a Slides presentation and export
 * all the embedded charts in this spreadsheet
 * to it, one chart per slide.
 */
function exportChartsToSlides() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // Fetch a list of all embedded charts in this
  // spreadsheet.
  var charts = [];
  var sheets = ss.getSheets();
  for (var i = 0; i < sheets.length; i++) {
    charts = charts.concat(sheets[i].getCharts());
  }
  
  // If there aren't any charts, display a toast
  // message and return without doing anything
  // else.
  if (charts.length == 0) {
    ss.toast('No charts to export!');
    return;
  }
  
  // Create a Slides presentation, removing the default
  // title slide.
  var presentationTitle =
    ss.getName() + " Presentation";
  var slides = SlidesApp.create(presentationTitle);
  slides.getSlides()[0].remove();  
  
  // Add charts to the presentation, one chart per slide.
  var position = {left: 40, top: 30};
  var size = {height: 340, width: 430};
  for (var i = 0; i < charts.length; i++) {
    var newSlide = slides.appendSlide();
    newSlide.insertSheetsChart(
      charts[i],
      position.left,
      position.top,
      size.width,
      size.height);   
  }
  
  // Create and display a dialog telling the user where to
  // find the new presentation.
  var slidesUrl = slides.getUrl();
  var html = "<p>Find it in your home Drive folder:</p>"
      + "<p><a href=\"" + slidesUrl + "\" target=\"_blank\">"
      + presentationTitle + "</a></p>";
  
  SpreadsheetApp.getUi().showModalDialog(
    HtmlService.createHtmlOutput(html)
      .setHeight(120)
      .setWidth(350),
      "Created a presentation!"
  );
}

2. Salva il progetto di script.

Revisione del codice

Questo codice potrebbe essere più breve del previsto. Rivediamo cosa sta facendo il codice suddividendo il codice in cinque sezioni:

1: ottieni i grafici

Le prime righe fanno una ricerca nel foglio di lavoro attivo per trovare tutti i grafici incorporati, raccogliendoli nell'array charts. Queste righe utilizzano il metodo Spreadsheet.getSheets() e il metodo Sheet.getCharts() per generare elenchi di fogli e grafici. Il metodo JavaScript Array.concat() viene utilizzato per aggiungere l'elenco dei grafici di ogni foglio a charts.

2: verifica che ci siano grafici da esportare

Il codice verifica se ci sono grafici da esportare. Vogliamo evitare di creare una presentazione vuota, per cui se non ci sono grafici, il codice crea invece un messaggio di toast utilizzando Spreadsheet.toast(message). Si tratta di una piccola finestra di dialogo che compare nell'angolo in basso a destra di Fogli e che rimane per alcuni secondi, per poi scomparire:

Punto chiave: i messaggi toast sono ottimi per mostrare all'utente qualcosa che si è verificato, ma non è qualcosa a cui deve reagire. In questo caso, il messaggio toast indica all'utente che l'azione del menu è stata completata correttamente, ma non ha generato nulla perché non sono presenti grafici da esportare.

Se il codice didn't crea il messaggio toast, sembrerebbe che la voce di menu non stia facendo nulla e l'utente potrebbe pensare che lo script sia danneggiato. È sempre consigliabile informare gli utenti delle operazioni eseguite dagli script, anche quando si verificano condizioni di errore.

Se non sono disponibili grafici da esportare, il codice crea il messaggio toast e si chiude senza eseguire altre operazioni. Se sono presenti grafici da esportare, il codice continua a creare una presentazione nelle righe successive.

3: crea una presentazione

La variabile presentationTitle è stata creata per contenere il nome del nuovo file di presentazione. È impostato come nome del foglio di lavoro e la riga Presentation è concatenata alla fine. Il codice chiama quindi il metodo di servizio Presentazioni SlidesApp.create(name) per creare una presentazione.

Nota:la classe SlidesApp funge da classe principale per il servizio Presentazioni, proprio come SpreadsheetApp è la classe principale per il servizio Foglio di lavoro.

Le nuove presentazioni vengono create con una singola diapositiva vuota. Non vogliamo che questo sia presente nella nostra presentazione, pertanto il codice lo rimuove con Presentation.getSlides() e Slide.remove().

4: esporta i grafici

Nella sezione successiva, il codice definisce position e size degli oggetti JavaScript da impostare per posizionare il grafico importato nella diapositiva e per indicare le dimensioni del grafico (in pixel).

Nota:gli elementi delle pagine di Presentazioni, come grafici importati, caselle di testo e forme, richiedono posizioni e dimensioni specifiche. Per saperne di più su come Apps Script imposta questi valori, consulta la guida relativa agli elementi di dimensioni e posizionamento.

Il codice si riflette su ogni grafico dell'elenco. Per ogni grafico, viene creato un elemento newSlide con Presentation.appendSlide(), che aggiunge la diapositiva alla fine della presentazione. Per importare il grafico nella diapositiva con i valori position e size specificati, viene utilizzato il metodo Slide.insertSheetsChart(sourceChart, left, top, width, height).

5. Condividere il luogo della presentazione

Infine, il codice deve indicare all'utente la posizione della nuova presentazione, preferibilmente con un link su cui può fare clic per aprirla. A tale scopo, il codice utilizza il servizio HTML di Apps Script per creare una finestra di dialogo modale personalizzata. Le finestre di dialogo modali (note anche come finestre di dialogo personalizzate in Apps Script) sono finestre che vengono visualizzate sull'interfaccia di Fogli. Se visualizzate, le finestre di dialogo personalizzate impediscono all'utente di interagire con Fogli.

Punto chiave: le finestre di dialogo modali sono perfette per creare uno script che permetta all'utente di procedere in modo specifico o per assicurarsi che l'utente visualizzi qualcosa prima di poter continuare a lavorare in Fogli Google.

Il servizio HTML di Apps Script ti consente di controllare completamente lo stile e i contenuti delle finestre di dialogo personalizzate con HTML e JavaScript standard. Ciò significa che puoi aggiungere testo, pulsanti, immagini e altre elementi interattivi alla finestra di dialogo. Questi argomenti non rientrano nell'ambito di questo codelab, ma se vuoi saperne di più, consulta le guide Creare e pubblicare HTML e Comunicazioni server-client.

Per creare una finestra di dialogo personalizzata, il codice richiede l'HTML che ne definisce i contenuti. Viene fornito nella variabile html. I contenuti includono un breve paragrafo e un link ipertestuale. Il link ipertestuale è la variabile presentationTitle, collegata all'URL della presentazione fornito da Presentation.getUrl(). Il link ipertestuale utilizza anche l'attributo target="_blank" per consentire l'apertura della presentazione in una nuova scheda del browser anziché all'interno della finestra di dialogo.

Il codice HTML viene analizzato in un oggetto HtmlOutput con il metodo HtmlService.createHtmlOutput(html). L'oggetto HtmlOutput consente al codice di impostare le dimensioni della finestra di dialogo personalizzata con HtmlOutput.setHeight(height) e HtmlOutput.setWidth(width).

Una volta creato htmlOutput, il codice utilizza il metodo Ui.showModalDialog(htmlOutput, title) per visualizzare la finestra di dialogo con il titolo specificato.

Risultati

Ora che hai implementato la seconda voce di menu, puoi vederla in azione. Per testare la funzione exportChartsToSlides():

1. Se non l'hai ancora fatto, salva il progetto script nell'editor Apps Script.
2. Apri il foglio di lavoro e fai clic sulla voce di menu Presenta set di dati > Grafico "Date e Tassi di cambio USD" per creare un grafico da esportare. Verrà visualizzata ancorata alla cella H5 nel foglio attivo.
3. Fai clic sulla voce di menu Avvia set di dati > Esporta grafici in Presentazioni. È possibile che ti venga chiesto di autorizzare nuovamente lo script.
4. Dovresti vedere lo script che elabora la richiesta e visualizzare la finestra di dialogo personalizzata.
5. Per aprire la nuova presentazione Presentazioni, fai clic sul link Presentazione di date e tassi di cambio in USD:

Se vuoi, puoi anche aggiungere altri grafici al foglio di lavoro e selezionare nuovamente la voce di menu per creare una presentazione con più diapositive.

Nota: i grafici visualizzati nella presentazione sono grafici collegati. Ciò significa che sono ancora collegati al grafico originale in Fogli. Se apporti una modifica al grafico di Fogli originale, puoi aggiornare il grafico collegato in Presentazioni utilizzando il pulsante Aggiorna nel grafico. Puoi anche forzare un aggiornamento usando il metodo SheetCharts.refresh().

Ora puoi esportare i grafici creati in Fogli in una presentazione Google. Puoi anche scrivere codice per creare una finestra di dialogo personalizzata.

Hai completato l'ultimo esercizio di questo codelab. Passa alla sezione successiva per rivedere le informazioni apprese.

5. Conclusione

Congratulazioni! Hai completato questo codelab e l'intera playlist del codelab su Fundamentals di Apps Script con Fogli Google. Puoi utilizzare i principi insegnati in questa playlist per estendere la tua esperienza in Fogli e scoprire le funzionalità di Apps Script.

Hai trovato utile questo codelab?

Sì No

Cosa hai imparato

• Come creare un grafico a linee incorporato con Apps Script.
• Come presentare a un utente messaggi toast e finestre di dialogo personalizzate in Fogli.
• Come esportare un grafico in una nuova presentazione in Presentazioni.

Concetti principali:

1. Il servizio Fogli di lavoro utilizza EmbeddedChart e le classi di creazione associate per creare e modificare i grafici che vengono visualizzati in Fogli. Il servizio Classifiche viene utilizzato per creare e modificare i grafici utilizzati al di fuori di Fogli, ad esempio nelle app web di Apps Script.
2. I messaggi toast vengono utilizzati in Fogli per fornire all'utente un messaggio di avviso di breve durata, senza richiedere il suo intervento.
3. Le finestre di dialogo personalizzate sono finestre di dialogo modali create con HTML e JavaScript. Se visualizzate, le finestre di dialogo personalizzate impediscono all'utente di interagire con Fogli. Le finestre di dialogo personalizzate sono ideali per chiedere all'utente di inserire informazioni che devono essere eseguite dallo script o per far sì che l'utente legga qualcosa prima di continuare a lavorare in Fogli.
4. Quando un file con uno script associato a un contenitore viene copiato, la copia del file conserva una copia dello script associato. Se modifichi il testo, questa non si riflette nell'originale e viceversa.
5. I grafici collegati in Presentazioni sono collegati al grafico originale in Fogli. Se modifichi il grafico di Fogli originale, puoi aggiornare il grafico collegato in Presentazioni in modo che rifletta le modifiche apportate.

Termini chiave:

• Attivo (stato): indica il foglio di lavoro, il foglio, l'intervallo o la cella specificato che è l'utente del foglio di lavoro attualmente visualizzato o evidenziato.
• Cessa attiva: la singola cella evidenziata all'interno del foglio attivo con lo stato attivo del cursore.
• Intervallo attivo: un gruppo di una o più celle attualmente evidenziate nel foglio attivo.
• Autorizzazione: il processo con cui l'utente concede le autorizzazioni per consentire ad Apps Script di accedere ai dati dell'utente nei servizi Google pertinenti o che esegue altre azioni per conto dell'utente.
• Script associato a un contenitore: qualsiasi script associato e creato a partire da un documento Google Workspace, ad esempio un foglio Google o un documento Google.
• Finestra di dialogo personalizzata: una finestra di dialogo modale personalizzabile, creata in HTML e JavaScript, utilizzata per fornire informazioni o interattività agli utenti. Se visualizzate, le finestre di dialogo personalizzate impediscono all'utente di interagire con Fogli.
• EmbeddedChart: un grafico incorporato in un foglio di lavoro.
• EmbeddedChartBuilder: una classe o un generatore utilizzato per creare o modificare un EmbeddedChart.
• Funzione helper: una funzione, generalmente privata, chiamata da un altro utente per completare una piccola attività secondaria. Le funzioni helper vengono utilizzate quando l'attività secondaria deve essere completata molte volte in posizioni diverse.
• JSON: formato di file per la definizione degli oggetti di dati e delle loro caratteristiche nel testo.
• onOpen(): se definito in uno script, si tratta di un attivatore semplice che si attiva ogni volta che un file si apre o si ricarica.
• Grafico collegato: in Presentazioni, un grafico collegato a un grafico originale in Fogli. Se modifichi il grafico di Fogli originale, puoi aggiornare il grafico collegato in Presentazioni in modo che rifletta le modifiche apportate.
• Finestra di dialogo modulare: vai alla finestra di dialogo personalizzata.
• Presentazione: un file di Presentazioni Google su Google Drive. Il corso Presentation ti consente di accedere e modificare le presentazioni.
• Intervallo**: un gruppo di una o più celle adiacenti all'interno di un foglio. Il corso Range** consente di leggere e aggiornare gli intervalli all'interno di un foglio.
• Editor di script: l'editor di codice nel browser per Apps Script.
• Attivatori semplici: un sottotipo di attivatori in Apps Script con i nomi delle funzioni di attivazione riservate e determinate limitazioni.
• Foglio**: una singola pagina di un foglio di lavoro. Talvolta utilizzato per fare riferimento a un file di Fogli Google su Google Drive. Il corso Sheet** ti consente di accedere e modificare i fogli.
• Diapositiva: una singola diapositiva all'interno di una presentazione. Il corso Slide ti consente di accedere e modificare le diapositive.
• SlidesApp: questo corso funge da classe principale per il servizio Presentazioni e fornisce un punto di partenza per il codice che legge o manipola i dati di Presentazioni Google.
• SpreadsheetApp: questa classe funge da classe principale per il servizio Foglio di lavoro e fornisce un punto di partenza per il codice che legge o manipola i dati di Fogli Google.
• Foglio di lavoro**: un file di Fogli Google che si trova all'interno di Google Drive. Il corso Spreadsheet** consente di accedere e modificare i fogli di lavoro.
• Servizio Fogli di lavoro: un servizio Apps Script che consente agli script di creare, accedere e modificare i file di Fogli Google.
• Toast: una finestra di dialogo di breve durata utilizzata per informare gli utenti di alcuni eventi o processi in Fogli Google.
• Trigger: un evento associato a una funzione Apps Script. Quando si verifica l'evento (ad esempio l'apertura di un foglio di lavoro), l'attivatore "viene attivato" ed esegue automaticamente la funzione Apps Script associata.
• Servizio di recupero URL: il servizio Apps Script che consente agli script di connettersi agli endpoint URL per effettuare richieste e ricevere risposte.

Passaggi successivi

Hai completato questa playlist. Tuttavia, c'è ancora altro da scoprire su Apps Script.

Consulta queste risorse:

• Documentazione per gli sviluppatori di Apps Script
• Guide di Apps Script
• Documentazione di riferimento di Apps Script
• Domande di Apps Script su StackOverflow
• Esempi di codice di Apps Script su GitHub

Buon script!

Hai trovato utile questa playlist di codelab?

Sì No

Vuoi visualizzare altri codelab di Apps Script in futuro?

Sì No