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 aumentar os dados significativos para seu público. Os gráficos são ferramentas muito eficientes para mostrar padrões ou tendências em um conjunto de dados, e pode 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. A Slides API permite incluir qualquer gráfico que você criados no Planilhas Google: gráficos de barras, gráficos de linhas, gráficos 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 dos resultados EmbeddedChart.
- Use CreateSheetsChartRequest. uma vez para adicioná-lo a um slide.
- Use o RefreshSheetsChartRequest conforme necessário para sincronizá-los com os dados de origem.
Gráficos estáticos x vinculados
Quando você usa a API para adicionar um gráfico à sua apresentação, um parâmetro que especificado é o LinkingMode (em inglês). Determina se o gráfico é adicionado como uma imagem estática ou um objeto que podem ser atualizadas no futuro.
Use o modo LINKED
se:
- Você quer atualizar o gráfico no futuro, refletindo as mudanças no dos dados.
- Você quer que os colaboradores tenham um link para a planilha que contém a fonte gráfico.
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 aplicativo já usa um dos outros escopos,
listados acima, use esse escopo.
Como adicionar um gráfico
Para adicionar um gráfico, você precisa saber o ID da planilha e o ID do gráfico do
gráfico no Planilhas Google. Em seguida, chame o método batchUpdate
usando a
CreateSheetsChartRequest
uma vez para adicionar o gráfico.
O exemplo a seguir usa um gráfico e o adiciona a um slide como LINKED
. Portanto,
que pode 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
à sua apresentação, é possível atualizá-lo
a qualquer momento usando
RefreshSheetsChartRequest.
Isso atualiza o gráfico para deixá-lo sincronizado com o gráfico subjacente do Planilhas e
os dados em que ele se baseia.
O exemplo a seguir atualiza um gráfico: