En esta página, se describe cómo tomar gráficos existentes de Hojas de cálculo de Google y agregarlos a Presentaciones de Google.
Agregar gráficos a una presentación puede ayudar a generar un mayor impacto y hacer que los datos sean significativos para tu público. Los gráficos son herramientas cuya capacidad única es útil para mostrar patrones o tendencias en un conjunto de datos, y pueden ayudarte a comunicarte con claridad sobre los datos cuantitativos.
El vídeo anterior explica cómo generar diapositivas a partir de datos de hojas de cálculo. Se incluye un ejemplo completo (Python) que agrega un gráfico a una diapositiva y también importa datos de celdas de una hoja de cálculo a una tabla.
Información sobre cómo agregar gráficos
Cuando presentas información cuantitativa, los gráficos de datos pueden mejorar tu presentación. La API de Presentaciones te permite incluir cualquier gráfico que puedas crear en Hojas de cálculo de Google: gráficos de barras, de líneas, circulares y muchos más.
Como se muestra en el diagrama anterior, primero debes crear el gráfico en Google Sheets. Una vez que el gráfico exista, podrás incrustarlo en tu presentación.
El proceso general de administración de gráficos en tu presentación es el siguiente:
- Crear un gráfico en Hojas de cálculo de Google
- Usa la API de Hojas de cálculo para leer el ID del gráfico del EmbeddedChart resultante.
- Usa CreateSheetsChartRequest una vez para agregarlo a una diapositiva.
- Utiliza RefreshSheetsChartRequest según sea necesario para sincronizarlo con los datos de origen.
Gráficos estáticos y vinculados
Cuando usas la API para agregar un gráfico a tu presentación, un parámetro que especificas es LinkingMode. Esto determina si el gráfico se agrega como una imagen estática o como un objeto que se pueda actualizar en el futuro.
Usa el modo LINKED
en los siguientes casos:
- Deseas actualizar el gráfico en el futuro y reflejar los cambios en los datos subyacentes.
- La idea es que los colaboradores tengan un vínculo a la hoja de cálculo que contiene el gráfico de fuentes.
Usa el modo (estático) NOT_LINKED_IMAGE
en los siguientes casos:
- Quieres que el gráfico nunca cambie en el futuro.
- No quieres que los colaboradores vean un vínculo a la hoja de cálculo de origen.
Alcances para acceder a Hojas de cálculo de Google
Cuando agregas un gráfico a tu diapositiva, la API de Presentaciones debe acceder a él en Google Sheets. Esto significa que tu solicitud debe usar uno de los siguientes alcances:
https://www.googleapis.com/auth/spreadsheets.readonly
(recomendada)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
El alcance spreadsheets.readonly
suele ser la mejor opción, ya que es el más restrictivo. Sin embargo, si tu app ya usa uno de los otros alcances mencionados anteriormente, solo usa ese.
Agrega un gráfico
Para agregar un gráfico, deberás conocer el ID de hoja de cálculo y el ID del gráfico en Hojas de cálculo de Google. Luego, debes llamar al método batchUpdate
y usar CreateSheetsChartRequest una vez para agregar el gráfico.
En el siguiente ejemplo, se toma un gráfico y se agrega a una diapositiva como LINKED
para que se pueda actualizar más adelante.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Actualiza un gráfico
Si incorporaste un gráfico LINKED
en tu presentación, puedes actualizarlo en cualquier momento con RefreshSheetsChartRequest.
Esto actualiza el gráfico para sincronizarlo con el gráfico y los datos subyacentes de Hojas de cálculo en los que se basa.
En el siguiente ejemplo, se actualiza un gráfico existente: