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 poderosas exclusivamente 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 a partir de dados de 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 poderão aprimorar sua apresentação. Com a Slides API, você pode incluir qualquer gráfico que criar no Planilhas Google: de barras, de linhas, de pizza e muito mais.
Como mostrado no diagrama acima, você deve primeiro criar o gráfico no Planilhas Google. Depois de criar o gráfico, você pode 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
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 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 mude no futuro.
- Você não quer que os colaboradores tenham acesso a um link para a planilha de origem.
Escopos para acessar as Planilhas Google
Quando você adiciona um gráfico a um 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
(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 a ser usado, porque é
o mais restritivo. No entanto, se o app já usa um dos outros escopos
listados acima, use-o.
Como 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 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
Como atualizar um gráfico
Se você incorporou um gráfico LINKED
na apresentação, poderá atualizá-lo
a qualquer momento usando
RefreshSheetsChartRequest.
Isso atualiza o gráfico para que ele seja sincronizado com o gráfico subjacente do Planilhas e os dados em que ele se baseia.
O exemplo a seguir atualiza um gráfico: