L'API Google Sheets est une interface RESTful qui vous permet de lire et de modifier les données d'une feuille de calcul. Les utilisations les plus courantes de cette API sont les suivantes:
- Créer des feuilles de calcul
- Lire et écrire des valeurs de cellule de 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 pouvant contenir plusieurs feuilles, chacune contenant des informations structurées dans des cellules. Une ressource de feuille de calcul représente chaque feuille de calcul et possède une valeur
spreadsheetId
unique, contenant des lettres, des chiffres, des traits d'union ou des traits de soulignement. Vous trouverez cet ID dans une URL Google Sheets:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- Feuille
Page ou onglet dans une feuille de calcul. Une ressource "Feuille" représente chaque feuille. Elle possède un titre et une valeur
sheetId
numériques uniques. Vous trouverez cet ID dans une URL Google Sheets:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- Cellule
Champ individuel de texte ou de données dans une feuille. Les cellules sont organisées sous forme de lignes et de colonnes, et peuvent être regroupées en tant que plage de cellules. Une ressource CellData représente chaque cellule, mais elle n'a pas de valeur d'ID unique. Les coordonnées de ligne et de colonne identifient plutôt les cellules.
- Notation A1
Syntaxe utilisée pour définir une cellule ou une plage de cellules avec une chaîne contenant le nom de la feuille, plus les coordonnées de cellule de début et de fin à l'aide des lettres de colonne et des numéros de ligne. Cette méthode est la plus courante et la plus utile pour référencer une plage de cellules absolue.
Afficher des exemples
Sheet1!A1:B2
fait référence aux deux premières cellules des deux premières lignes de Sheet1.Sheet1!A:A
fait référence à toutes les cellules de la première colonne de la feuille 1.Sheet1!1:2
fait référence à toutes les cellules des deux premières lignes de la Feuille 1.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 aux deux premières cellules des deux premières lignes de la première feuille visible.Sheet1
fait référence à toutes les cellules de la Feuille 1.'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". Des guillemets simples sont requis pour les noms de feuilles comportant des espaces, des caractères spéciaux ou une combinaison alphanumérique.'My Custom Sheet'
fait référence à toutes les cellules de "Ma feuille personnalisée".
Conseil: Dans la mesure du possible, utilisez des noms distincts pour les objets contenus dans vos feuilles de calcul. Par exemple, A1 fait référence à la cellule A1 de la première feuille visible, tandis que "A1" fait référence à toutes les cellules de la feuille A1. De même, "Feuille 1" fait référence à toutes les cellules de la Feuille 1. En revanche, s'il existe une plage nommée "Feuille1", "Feuille1" fait référence à la plage nommée et "Feuille1" à la feuille.
- Notation R1C1
Syntaxe utilisée pour définir une cellule ou une plage de cellules avec une chaîne contenant le nom de la feuille, plus les coordonnées de cellule de début et de fin à l'aide des numéros de ligne et des numéros 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.
Afficher des exemples
Sheet1!R1C1:R2C2
fait référence aux deux premières cellules des deux premières lignes de Sheet1.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 qui se compose de trois lignes en dessous et d'une colonne à droite de la cellule active.
- Plage nommée
Cellule ou plage de cellules définie 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éfinie qui ne peut pas être modifiée. Une ressource ProtectedRange représente une plage protégée.
Étapes suivantes
Pour en savoir plus sur le développement avec les API Google Workspace, y compris la gestion de l'authentification et de l'autorisation, consultez la page Développer sur Google Workspace.
Pour apprendre à configurer et exécuter une application simple avec l'API Sheets, consultez la présentation des guides de démarrage rapide.