Présentation de l'API Google Sheets

L'API Google Sheets est une interface RESTful qui vous permet de lire et de modifier un données de la feuille de calcul. Les utilisations les plus courantes de cette API sont les suivantes : tâches:

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

Voici une liste des termes couramment utilisés dans cette API:

Feuille de calcul

L'objet principal dans Google Sheets pouvant contenir plusieurs feuilles, chacune avec des informations structurées contenues dans des cellules. Un Spreadsheet "resource" représente feuille de calcul et dispose d’une Valeur de spreadsheetId, contenant des lettres, des chiffres, des traits d'union ou des traits de soulignement. Vous trouverez ID de feuille de calcul dans une URL Google Sheets:

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

Feuille

Une page ou un onglet d'une feuille de calcul. Un Sheet ressource représente chaque d'une feuille de calcul avec un titre unique sheetId. Toi 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 disposées en lignes et des colonnes, et peuvent être regroupés sous forme de plage de cellules. Un CellData ressource représente chaque mais elle n'a pas de valeur d'ID unique. Au lieu de cela, les lignes et les colonnes les coordonnées à identifier les cellules.

Notation A1
Syntaxe utilisée pour définir une cellule ou une plage de cellules avec une chaîne qui contient le nom de la feuille plus les coordonnées de cellule de début et de fin en utilisant des lettres de colonnes et des numéros de ligne. Cette méthode est la plus courante et la plus utile lorsque vous faites référence à 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 Feuille1.
  • 'Jon's_Data'!A1:D5 fait référence à toutes les cellules des cinq premières lignes et des quatre colonnes d'une feuille nommée "Jean's_Data".
  • 'My Custom Sheet'!A:A fait référence à toutes les cellules de la première colonne d'une feuille intitulé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 feuille contenant des espaces, des caractères spéciaux ou une combinaison alphanumérique.

Conseil: Dans la mesure du possible, attribuez des noms distincts aux objets de 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, Sheet1 fait référence à toutes les cellules de Sheet1. Toutefois, s'il existe une plage nommée "Feuille1", Feuille1 fait référence à la plage nommée et Sheet1 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 qui contient le nom de la feuille plus les coordonnées de cellule de début et de fin en utilisant les numéros de ligne et de colonne. Cette méthode est moins courante que la notation A1, mais peut être utile pour référencer une plage de cellules par rapport à une la position de la cellule.

Voir les 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 située trois lignes en dessous et une colonne à droite de la cellule active.
Plage nommée
Cellule ou plage de cellules définie avec un nom personnalisé pour simplifier de référence dans une application. Un FilterView ressource représente une plage nommée.
Plage protégée
Cellule ou plage de cellules définie qui ne peut pas être modifiée. A ProtectedRange ressource représente une plage protégée.