Cette page explique comment récupérer des graphiques existants dans Google Sheets et les ajouter à des présentations Google Slides.
Ajouter des graphiques à une présentation peut avoir plus d'impact et rendre les données plus compréhensibles pour votre audience. Les graphiques sont des outils particulièrement efficaces pour montrer des tendances ou des schémas dans un ensemble de données, et peuvent vous aider à communiquer clairement sur des données quantitatives.
La vidéo ci-dessus explique comment générer des diapositives à partir de données de feuille de calcul. Elle inclut un exemple complet (Python) qui ajoute un graphique à une diapositive et importe également des données de cellules de feuille de calcul dans un tableau.
À propos de l'ajout de graphiques
Lorsque 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 linéaires, graphiques en secteurs, etc.

Comme illustré dans 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 de l'EmbeddedChart obtenu EmbeddedChart.
- Utilisez CreateSheetsChartRequest une seule fois pour l'ajouter à une diapositive.
- Utilisez RefreshSheetsChartRequest si nécessaire pour le synchroniser avec les données sources.
Graphiques statiques ou liés
Lorsque vous utilisez l'API pour ajouter un graphique à votre présentation, un paramètre que vous spécifiez est le LinkingMode. Il détermine si le graphique est ajouté en tant qu'image statique ou en tant qu'objet qui peut être actualisé ultérieurement.
Utilisez le mode LINKED si :
- vous souhaitez actualiser le graphique ultérieurement pour 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) si :
- vous ne voulez pas que le graphique change à l'avenir ;
- vous ne voulez pas que les collaborateurs voient un lien vers la feuille de calcul source.
Champs d'application pour 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/spreadsheetshttps://www.googleapis.com/auth/drive.readonlyhttps://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.
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. Appelez ensuite la méthode batchUpdate, en utilisant
CreateSheetsChartRequest
une seule 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.
Le graphique est alors mis à jour pour être synchronisé avec le graphique Sheets sous-jacent et les données sur lesquelles il est basé.
L'exemple suivant actualise un graphique existant :