L'API Google Sheets est une interface RESTful qui vous permet de lire et de modifier les données d'une feuille de calcul. L'API Sheets vous permet d'effectuer les opérations suivantes :
- Créer des feuilles de calcul
- Lire et écrire les valeurs des cellules d'une feuille de calcul
- Mettre à jour la mise en forme de la feuille de calcul
- Gérer les feuilles connectées
Voici une liste des termes courants utilisés dans l'API Sheets :
- Feuille de calcul
Objet principal dans Google Sheets. Il peut contenir plusieurs
Sheets
, chacun avec des informations structurées contenues dansCells
. La ressourcespreadsheets
représente une feuille de calcul. Il contient une valeurspreadsheetId
unique.- ID de la feuille de calcul
- Identifiant unique d'une feuille de calcul. Il s'agit d'une chaîne particulière contenant des lettres, des chiffres et certains caractères spéciaux qui font référence à une feuille de calcul. Elle peut être dérivée de l'URL de la feuille de calcul. Les ID de feuille de calcul sont stables, même si le nom de la feuille de calcul change.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
- Sheets
Page ou onglet d'une feuille de calcul. La ressource
Sheets
représente une feuille. Il contient une valeur numériquesheetId
unique et une feuilletitle
dans l'objetSheetProperties
.- ID de la feuille
- Identifiant unique d'une feuille spécifique au sein d'une feuille de calcul. Il s'agit d'une chaîne spécifique contenant des lettres, des chiffres et certains caractères spéciaux qui font référence à une feuille. Il peut être dérivé de l'URL de la feuille de calcul. Les ID de feuille sont stables, même si le nom de la feuille change. Pour obtenir un exemple, consultez la section ID de feuille de calcul.
- Cell
Champ individuel de texte ou de données dans une feuille. Les cellules sont organisées en lignes et en colonnes, et peuvent être regroupées en plage de cellules. La ressource
Cells
représente chaque cellule, mais n'a pas de valeur d'ID unique. À la place, les coordonnées de ligne et de colonne identifient les cellules.- Notation A1
- Syntaxe utilisée pour définir une cellule ou une plage de cellules à l'aide d'une chaîne contenant le nom de la feuille, ainsi que les coordonnées de début et de fin de la cellule à l'aide de lettres de colonne et de numéros de ligne. Cette méthode est la plus courante et la plus utile pour référencer une plage absolue de cellules.
Voir les exemples
Sheet1!A1:B2
fait référence à toutes les cellules des deux premières lignes et colonnes de Sheet1.Sheet1!A:A
fait référence à toutes les cellules de la première colonne de Feuille1.Sheet1!1:2
fait référence à toutes les cellules des deux premières lignes de Sheet1.Sheet1!A5:A
fait référence à toutes les cellules de la première colonne de la feuille 1, à partir de la ligne 5.A1:B2
fait référence à toutes les cellules des deux premières lignes et colonnes de la première feuille visible.Sheet1
fait référence à toutes les cellules de la feuille 1.'Jon's_Data'!A1:D5
fait référence à toutes les cellules des cinq premières lignes et des quatre premières colonnes d'une feuille nommée "Jon's_Data".'My Custom Sheet'!A:A
fait référence à toutes les cellules de la première colonne d'une feuille nommée "Ma feuille personnalisée".'My Custom Sheet'
fait référence à toutes les cellules de "Ma feuille personnalisée".
Les guillemets simples sont obligatoires pour les noms de feuilles contenant des espaces, des caractères spéciaux ou une combinaison alphanumérique.
Conseil : Dans la mesure du possible, utilisez des noms distincts pour les objets de vos feuilles de calcul. Par exemple, A1 (sans guillemets) fait référence à la cellule A1 de la première feuille visible.
'A1'
fait référence à une feuille nommée A1. De même, Sheet1 fait référence à une feuille portant le nom Sheet1. Toutefois, si une plage nommée est intitulée "Sheet1", Sheet1 fait référence à la plage nommée et'Sheet1'
à la feuille.- Notation R1C1
- Syntaxe utilisée pour définir une cellule ou une plage de cellules à l'aide d'une chaîne contenant le nom de la feuille, ainsi que les coordonnées de début et de fin de la cellule à l'aide de numéros de ligne et de colonne. Cette méthode est moins courante que la notation A1, mais elle peut être utile pour référencer une plage de cellules par rapport à la position d'une cellule donnée.
Voir les exemples
Sheet1!R1C1:R2C2
fait référence aux deux premières cellules des deux premières lignes de la feuille 1.R1C1:R2C2
fait référence aux deux premières cellules des deux premières lignes de la première feuille visible.Sheet1!R[3]C[1]
fait référence à la cellule située trois lignes en dessous et une colonne à droite de la cellule active.
- Plage nommée
- Cellule ou plage de cellules définies avec un nom personnalisé pour simplifier les références dans une application. Une ressource
FilterView
représente une plage nommée. - Plage protégée
- Cellule ou plage de cellules définies qui ne peuvent pas être modifiées. Une ressource
ProtectedRange
représente une plage protégée.
Articles associés
Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion de l'authentification et de l'autorisation, consultez Développer sur Google Workspace.
Pour découvrir comment configurer et exécuter une application de l'API Sheets, consultez le guide de démarrage rapide JavaScript.