En esta página, se describe cómo tomar gráficos existentes de Hojas de cálculo de Google y agregarlos a presentaciones de Presentaciones de Google.
Agregar gráficos a una presentación puede ayudar a crear un mayor impacto y hacer que los datos sean significativos para el público. Los gráficos son herramientas únicas y potentes para mostrar patrones o tendencias en un conjunto de datos y pueden ayudarte a comunicar de forma clara los datos cuantitativos.
En el video anterior, se explica cómo generar diapositivas a partir de datos de una hoja de cálculo. 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 para 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, gráficos de líneas, gráficos circulares y muchos más.
Como se muestra en el diagrama anterior, primero debes crear el gráfico en Hojas de cálculo de Google. Una vez que el gráfico exista, podrás incorporarlo a tu presentación.
El proceso general para administrar los gráficos en tu presentación es el siguiente:
- Crea 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.
- Usa RefreshSheetsChartRequest según sea necesario para sincronizarlo con los datos de origen.
Gráficos estáticos frente a gráficos 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 puede actualizar en el futuro.
Usa el modo LINKED
en los siguientes casos:
- Quieres actualizar el gráfico en el futuro para reflejar los cambios en los datos subyacentes.
- Quieres que los colaboradores tengan un vínculo a la hoja de cálculo que contiene el gráfico fuente.
Usa el modo NOT_LINKED_IMAGE
(estático) 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 fuente.
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 Hojas de cálculo de Google. Esto significa que tu solicitud debe usar uno de los siguientes permisos:
https://www.googleapis.com/auth/spreadsheets.readonly
(recomendado)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
Por lo general, el alcance spreadsheets.readonly
es el mejor, ya que es el más restrictivo. Sin embargo, si tu app ya usa uno de los otros permisos mencionados anteriormente, solo usa ese permiso.
Cómo agregar un gráfico
Para agregar un gráfico, deberás conocer el ID de la hoja de cálculo y el ID del gráfico en Hojas de cálculo de Google. Luego, llama al método batchUpdate
con 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 subyacente de Hojas de cálculo y los datos en los que se basa.
En el siguiente ejemplo, se actualiza un gráfico existente: