In questa pagina viene descritto come acquisire grafici esistenti da Fogli Google e aggiungerli alle presentazioni di Presentazioni Google.
L'aggiunta di grafici a una presentazione può contribuire ad avere un impatto maggiore e a rendere i dati significativi per il tuo pubblico. I grafici sono strumenti straordinariamente potenti per mostrare pattern o tendenze in un set di dati e possono aiutarti a comunicare chiaramente i dati quantitativi.
Il video sopra riportato illustra come generare slide dai dati di un foglio di lavoro. Include un esempio completo (Python) che consente di aggiungere un grafico a una diapositiva e di importare i dati delle celle del foglio di lavoro in una tabella.
Informazioni sull'aggiunta di grafici
Ogni volta che presenti informazioni quantitative, i grafici di dati possono migliorare la presentazione. L'API Presentazioni ti consente di includere qualsiasi grafico che puoi creare in Fogli Google: grafici a barre, grafici a linee, grafici a torta e molti altri.
Come mostrato nel diagramma sopra, devi prima creare il grafico in Fogli Google. Una volta creato il grafico, puoi incorporarlo nella presentazione.
La procedura generale per la gestione dei grafici nella tua presentazione è la seguente:
- Crea un grafico in Fogli Google.
- Utilizza l'API Fogli per leggere l'ID del grafico risultante EmbeddedChart.
- Usa una volta CreateSheetsChartRequest per aggiungerlo a una diapositiva.
- Utilizza RefreshSheetsChartRequest come necessario per sincronizzarlo con i dati di origine.
Grafici statici e collegati
Quando utilizzi l'API per aggiungere un grafico alla presentazione, un parametro specificato è LinkingMode. Questo determina se il grafico viene aggiunto come immagine statica o come oggetto che può essere aggiornato in futuro.
Usa la modalità LINKED
se:
- In futuro vuoi aggiornare il grafico per riflettere le modifiche ai dati sottostanti.
- Vuoi che i collaboratori dispongano di un link al foglio di lavoro contenente il grafico di origine.
Usa la modalità NOT_LINKED_IMAGE
(statica) se:
- Il tuo obiettivo è fare in modo che il grafico non cambi mai in futuro.
- Non vuoi che i collaboratori vedano un link al foglio di lavoro di origine.
Ambiti per l'accesso a Fogli Google
Quando aggiungi un grafico alla diapositiva, l'API Presentazioni deve accedere al grafico in Fogli Google. Ciò significa che la richiesta deve utilizzare uno dei seguenti ambiti:
https://www.googleapis.com/auth/spreadsheets.readonly
(preferito)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
L'ambito spreadsheets.readonly
è in genere il migliore da utilizzare, perché è il più restrittivo. Tuttavia, se la tua app utilizza già uno degli altri ambiti elencati in precedenza, puoi utilizzare questo ambito.
Aggiunta di un grafico
Per aggiungere un grafico, devi conoscere l'ID foglio di lavoro e l'ID del grafico in Fogli Google. Quindi, chiama il metodo batchUpdate
, utilizzando
CreateSheetsChartRequest
una volta per aggiungere il grafico.
L'esempio seguente acquisisce un grafico e lo aggiunge a una slide come LINKED
in modo che possa essere aggiornato in un secondo momento.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Aggiornamento di un grafico
Se hai incorporato un grafico LINKED
nella presentazione, puoi aggiornarlo in qualsiasi momento utilizzando RefreshSheetsChartRequest.
In questo modo il grafico viene aggiornato per sincronizzarlo con il grafico sottostante di Fogli e i dati su cui è basato.
L'esempio seguente aggiorna un grafico esistente: