Esta página descreve como adicionar gráficos do Planilhas Google a apresentações Google
Adicionar gráficos a uma apresentação pode ajudar a criar mais impacto e tornar os dados mais significativos para seu público. Os gráficos são ferramentas únicas e poderosas para mostrar padrões ou tendências em um conjunto de dados e podem ajudar você a se comunicar claramente sobre dados quantitativos.
O vídeo acima discute como gerar slides de dados de uma planilha. Ele inclui um exemplo completo (Python) que adiciona um gráfico a um slide e também importa dados de células da planilha para uma tabela.
Sobre a adição de gráficos
Sempre que você apresentar informações quantitativas, os gráficos de dados podem aprimorar sua apresentação. Com a API Slides, você pode incluir qualquer gráfico que possa criar no Planilhas Google: gráficos de barras, de linhas, de pizza e muito mais.
Como mostrado no diagrama acima, você deve primeiro criar o gráfico no Planilhas Google. Quando o gráfico existir, você poderá incorporá-lo à apresentação.
O processo geral de gerenciamento de gráficos na sua apresentação é:
- Crie um gráfico no Planilhas Google.
- Use a API Sheets para ler o ID do gráfico do EmbeddedChart resultante.
- Use CreateSheetsChartRequest uma vez para adicioná-lo a um slide.
- Use RefreshSheetsChartRequest conforme necessário para sincronizá-lo com os dados de origem.
Gráficos estáticos x vinculados
Quando você usa a API para adicionar um gráfico à sua apresentação, é preciso especificar o LinkingMode como parâmetro. Isso determina se o gráfico é adicionado como uma imagem estática ou um objeto que pode ser atualizado no futuro.
Use o modo LINKED
se:
- Você quer atualizar o gráfico no futuro, refletindo as alterações nos dados subjacentes.
- Você quer que os colaboradores tenham um link para a planilha que contém o gráfico de origem.
Use o modo NOT_LINKED_IMAGE
(estático) se:
- Você quer que o gráfico nunca seja alterado no futuro.
- Você não quer que os colaboradores tenham acesso a um link para a planilha de origem.
Escopos para acessar o Planilhas Google
Quando você adiciona um gráfico a um slide, a API Slides precisa acessá-lo no Planilhas Google. Isso significa que a solicitação precisa usar um dos seguintes escopos:
https://www.googleapis.com/auth/spreadsheets.readonly
(recomendável)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
O escopo spreadsheets.readonly
geralmente é o melhor para usar, porque é
o mais restritivo. No entanto, se o app já usa um dos outros escopos
listados acima, basta usar esse escopo.
Como adicionar um gráfico
Para adicionar um gráfico, você precisa saber o ID da planilha e do gráfico no Planilhas Google. Em seguida, chame o método batchUpdate
usando CreateSheetsChartRequest uma vez para adicionar o gráfico.
O exemplo a seguir usa um gráfico e o adiciona a um slide como LINKED
para que possa ser atualizado mais tarde.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Atualizar um gráfico
Se você incorporou um gráfico LINKED
na sua apresentação, poderá atualizá-lo a qualquer momento usando RefreshSheetsChartRequest.
Isso atualiza o gráfico para que ele seja sincronizado com o gráfico do Planilhas e os dados em que ele se baseia.
O exemplo a seguir atualiza um gráfico existente: