Cette page explique comment utiliser des graphiques Google Sheets existants pour les ajouter à des présentations Google Slides.
L'ajout de graphiques à une présentation peut contribuer à créer plus d'impact et à rendre les données pertinentes 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. Il comprend un exemple complet (Python) qui ajoute un graphique à une diapositive et importe également les données des cellules de la 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 de graphique du EmbeddedChart obtenu.
- Utilisez CreateSheetsChartRequest une fois pour l'ajouter à une diapositive.
- Si nécessaire, utilisez RefreshSheetsChartRequest pour le synchroniser avec les données sources.
Graphiques statiques et graphiques associés
Lorsque vous utilisez l'API pour ajouter un graphique à votre présentation, vous spécifiez l'un des paramètres LinkingMode. Cela détermine si le graphique est ajouté en tant qu'image statique ou en tant qu'objet pouvant être actualisé à l'avenir.
Utilisez le mode LINKED
dans les cas suivants:
- Vous souhaitez actualiser le graphique à l'avenir, en reflétant 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 voulez 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 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 de spreadsheets.readonly
est généralement le meilleur à utiliser, car il est le plus restrictif. Toutefois, si votre application utilise déjà l'un des autres champs d'application répertoriés ci-dessus, utilisez-le.
Ajouter un graphique
Pour ajouter un graphique, vous devez connaître l'ID de la feuille de calcul et celui du graphique dans Google Sheets. Ensuite, 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 qu'il puisse être actualisé 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.
Cette opération met à jour le graphique pour qu'il soit synchronisé avec le graphique Sheets sous-jacent et les données sur lesquelles il est basé.
L'exemple suivant actualise un graphique existant: