Présentation de l'API Google Sheets

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 incluent les tâches suivantes:

  • Créer des feuilles de calcul
  • Lire et écrire les valeurs des cellules d'une feuille de calcul
  • Modifier la mise en forme de la feuille de calcul
  • Gérer les feuilles connectées

Voici une liste des termes couramment utilisés dans l'API Sheets:

Feuille de calcul

Objet principal dans Google Sheets qui peut contenir plusieurs feuilles, chacune contenant des informations structurées dans des cellules. Une ressource 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 l'identifiant d'une feuille de calcul dans une URL Google Sheets:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

Feuille

Une page ou un onglet dans une feuille de calcul. Une ressource de feuille représente chaque feuille, et possède un titre unique et une valeur numérique sheetId. Vous pouvez trouver l'ID de la feuille 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 en lignes et en colonnes et peuvent être regroupées sous forme de plage de cellules. Une ressource CellData représente chaque cellule, mais elle n'a pas de valeur d'ID unique. Au lieu de cela, 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 avec 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 des lettres de colonne et des numéros de ligne. Cette méthode est la plus courante et la plus utile lors du référencement d'une plage absolue de cellules.

Afficher des exemples

  • Sheet1!A1:B2 fait référence aux deux premières cellules des deux lignes supérieures de Sheet1.
  • Sheet1!A:A fait référence à toutes les cellules de la première colonne de Sheet1.
  • 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 aux deux premières cellules des deux lignes supérieures de la première feuille visible.
  • Sheet1 fait référence à toutes les cellules de Sheet1.
  • '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". Les guillemets simples sont obligatoires pour les noms de feuille contenant des espaces, des caractères spéciaux ou une combinaison de caractères alphanumériques.
  • '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 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 d'une feuille nommée A1. De même, Feuille1 fait référence à toutes les cellules de Feuille1. Toutefois, s'il existe une plage nommée intitulée "Feuille1", "Feuille1" fait référence à la plage nommée et "Feuille1" fait référence à 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, ainsi que les coordonnées de début et de fin des cellules à l'aide de numéros de ligne et de colonne. Cette méthode est moins courante que la notation A1, mais elle peut s'avérer utile pour faire référence à 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 lignes supérieures de Sheet1.
  • R1C1:R2C2 fait référence aux deux premières cellules des deux lignes supérieures 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 actuelle.
Plage nommée

Cellule ou plage de cellules définie avec un nom personnalisé pour simplifier les références tout au long d'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