Cette page explique comment extraire des graphiques Google Sheets existants et les ajouter aux présentations Google Slides.
L'ajout de graphiques à une présentation peut contribuer à créer plus d'impact et à rendre les données significatives pour votre public. Les graphiques sont des outils particulièrement puissants pour montrer des modèles ou des tendances dans un ensemble de données. Ils peuvent vous aider à communiquer clairement sur des données quantitatives.
La vidéo ci-dessus explique comment générer des diapositives à partir des données d'une feuille de calcul. Elle inclut un exemple complet (Python) qui ajoute un graphique à une diapositive et importe également les données des cellules d'une feuille de calcul dans un tableau.
À propos de l'ajout de graphiques
Chaque fois que vous présentez des informations quantitatives, les graphiques de données peuvent améliorer votre présentation. L'API Slides vous permet d'inclure n'importe quel graphique que vous pouvez créer dans Google Sheets: graphiques à barres, graphiques en courbes, graphiques à secteurs, etc.
Comme le montre le schéma ci-dessus, vous devez d'abord créer le graphique dans Google Sheets. Une fois le graphique créé, vous pouvez l'intégrer à votre présentation.
Le processus général de gestion des graphiques dans votre présentation est le suivant:
- Créez un graphique dans Google Sheets.
- Utilisez l'API Sheets pour lire l'ID du graphique EmbeddedChart obtenu.
- Utilisez CreateSheetsChartRequest une fois pour l'ajouter à une diapositive.
- Si nécessaire, utilisez RefreshSheetsChartRequest pour les synchroniser avec les données source.
Graphiques statiques et graphiques associés
Lorsque vous utilisez l'API pour ajouter un graphique à votre présentation, spécifiez l'un des paramètres LinkingMode. Cette option détermine si le graphique est ajouté en tant qu'image statique ou en tant qu'objet pouvant être actualisé ultérieurement.
Utilisez le mode LINKED
si:
- Vous souhaitez actualiser le graphique à l'avenir afin de refléter les modifications apportées aux données sous-jacentes.
- Vous souhaitez que les collaborateurs disposent d'un lien vers la feuille de calcul contenant le graphique source.
Utilisez le mode NOT_LINKED_IMAGE
(statique) dans les cas suivants:
- Vous souhaitez que le graphique ne change jamais à l'avenir.
- Vous ne souhaitez pas que les collaborateurs voient un lien vers la feuille de calcul source.
Champs d'application permettant d'accéder à Google Sheets
Lorsque vous ajoutez un graphique à votre diapositive, l'API Slides doit pouvoir y accéder dans Google Sheets. Cela signifie que votre requête doit utiliser l'un des champs d'application suivants:
https://www.googleapis.com/auth/spreadsheets.readonly
(rôle à privilégier)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
Le champ d'application spreadsheets.readonly
est généralement le plus adapté, car il est le plus restrictif. Toutefois, si votre application utilise déjà l'un des autres champs d'application listés ci-dessus, utilisez-le simplement.
Ajouter un graphique
Pour ajouter un graphique, vous devez connaître l'ID de la feuille de calcul et l'ID du graphique dans Google Sheets. Ensuite, vous appelez la méthode batchUpdate
en utilisant CreateSheetsChartRequest une fois pour ajouter le graphique.
L'exemple suivant prend un graphique et l'ajoute à une diapositive en tant que LINKED
afin de pouvoir l'actualiser ultérieurement.
Apps Script ;
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Actualiser un graphique
Si vous avez intégré un graphique LINKED
dans votre présentation, vous pouvez l'actualiser à tout moment à l'aide de RefreshSheetsChartRequest.
Le graphique est alors mis à jour pour le synchroniser avec le graphique Sheets sous-jacent et les données sur lesquelles il se base.
L'exemple suivant actualise un graphique existant: