Esta página descreve como usar gráficos do Planilhas Google e adicioná-los a apresentações do Apresentações Google.
Adicionar gráficos a uma apresentação pode ajudar a criar mais impacto e tornar os dados mais relevantes para o público. Gráficos são ferramentas únicas e poderosas para mostrar padrões ou tendências em um conjunto de dados que podem ajudar você a se comunicar claramente quando tratar de dados quantitativos.
O vídeo acima discute como gerar slides de dados de planilha. Ele inclui um exemplo completo (Python) que adiciona um gráfico a um slide e também importa dados de uma célula de planilha para uma tabela.
Sobre a adição de gráficos
Sempre que você apresentar informações quantitativas, os gráficos de dados podem melhorar a apresentação. A Slides API permite incluir qualquer gráfico que você criar nas Planilhas Google: gráfico de barras, de linha, de pizza e muitos outros.
Como mostrado no diagrama acima, é preciso criar antes o gráfico no Planilhas Google. Com o gráfico criado, você pode incorporá-lo à apresentação.
O procedimento geral para gerenciar gráficos na apresentação é:
- Crie um gráfico nas 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 sincronizar com os dados de origem.
Gráficos estáticos x vinculados
Ao usar a API para adicionar um gráfico à apresentação, você precisa especificar o parâmetro LinkingMode. Ele 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.
- 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ê não quer que o gráfico mude no futuro.
- Não quer que colaboradores tenham acesso a um link que aponta para a planilha de origem.
Escopos para acessar as Planilhas Google
Ao adicionar um gráfico a um slide, a API Slides precisa acessá-lo no app Planilhas Google. Isso significa que a sua solicitação deve 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 mais indicado por ser
o mais restritivo. No entanto, se o app já estiver usando um dos outros escopos
listados acima, use esse escopo.
Como adicionar um gráfico
Para adicionar um gráfico, você precisa conhecer o ID da planilha e o ID do gráfico
no app Planilhas Google. Em seguida, chame o método batchUpdate
usando a
CreateSheetsChartRequest
uma vez para adicionar o gráfico.
O exemplo a seguir usa e adiciona um gráfico a um slide como LINKED
para
que ele 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, é possível atualizá-lo
a qualquer momento usando
RefreshSheetsChartRequest.
Assim, você atualiza o gráfico para deixá-lo sincronizado com o gráfico das Planilhas e
os dados de base.
O exemplo a seguir atualiza um gráfico existente: