Esta página descreve como usar gráficos do Planilhas Google e adicioná-los a apresentações do Slides.
A adição de gráficos a uma apresentação pode ajudar a criar mais impacto e tornar os dados significativos para o público. Os gráficos são ferramentas muito eficientes 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 com dados de planilhas. Ele inclui um exemplo completo (Python) que adiciona um gráfico a um slide e também importa dados de células de planilhas para uma tabela.
Sobre a adição de gráficos
Sempre que você apresentar informações quantitativas, os gráficos de dados poderão melhorar sua apresentação. A API Slides permite incluir qualquer gráfico que você possa criar no Planilhas Google: gráficos de barras, de linhas, de pizza e muito mais.

Conforme mostrado no diagrama acima, primeiro é necessário criar o gráfico no Planilhas Google. Depois que o gráfico existir, você poderá incorporá-lo à sua apresentação.
O processo geral para gerenciar gráficos na apresentação é:
- Crie um gráfico no Planilhas Google.
- Use a API Sheets para ler o ID do gráfico do resultante EmbeddedChart.
- 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
Ao usar a API para adicionar um gráfico à sua apresentação, um parâmetro que você especifica é o LinkingMode. Isso determina se o gráfico é adicionado como uma imagem estática ou como um objeto que pode ser atualizado no futuro.
Use o modo LINKED se:
- Você quer atualizar o gráfico no futuro, refletindo as mudanças 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 mude no futuro.
- Você não quer que os colaboradores vejam um link para a planilha de origem.
Escopos para acessar o Planilhas Google
Ao adicionar um gráfico ao slide, a API Slides precisa acessá-lo no Planilhas Google. Isso significa que sua solicitação precisa usar um dos seguintes escopos:
https://www.googleapis.com/auth/spreadsheets.readonly(recomendado)https://www.googleapis.com/auth/spreadsheetshttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive
O escopo spreadsheets.readonly geralmente é o melhor a ser usado, porque é o mais restritivo. No entanto, se o app já usa um dos outros escopos listados acima, basta usar esse escopo.
Adicionar um gráfico
Para adicionar um gráfico, você precisa saber o ID da planilha e o ID do gráfico no Planilhas Google. Em seguida, chame o método batchUpdate, usando o
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 ele 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 sincronizá-lo com o gráfico e os dados subjacentes do Planilhas em que ele se baseia.
O exemplo a seguir atualiza um gráfico atual: