Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
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 :
Créer des feuilles de calcul
Lire et écrire les valeurs des cellules d'une feuille de calcul
Mettre à jour la mise en forme d'une 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 dans Cells. La ressource spreadsheets représente une feuille de calcul. Il contient une valeur spreadsheetId unique.
ID de la feuille de calcul
Identifiant unique d'une feuille de calcul. Il s'agit d'une chaîne de caractères spécifique 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.
Page ou onglet d'une feuille de calcul. La ressource Sheets représente une feuille. Il contient une valeur sheetId numérique unique et une feuille title dans l'objet SheetProperties.
ID de la feuille
Identifiant unique d'une feuille de calcul spécifique. Il s'agit d'un entier particulier contenant des nombres qui font référence à une feuille et qui peuvent être dérivés 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 ID de feuille de calcul.
Cell
Champ de texte ou de données individuel dans une feuille. Les cellules sont organisées en lignes et en colonnes, et peuvent être regroupées sous forme de plage de cellules. La ressource Cells représente chaque cellule, mais elle ne possède pas de valeur d'ID unique. Les cellules sont identifiées par les coordonnées de ligne et de colonne.
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 la cellule de début et de fin à l'aide de lettres de colonne et de numéros de ligne. Cette méthode est la plus courante et la plus utile pour faire référence à une plage absolue de cellules.
Sheet1!A1:B2 fait référence à toutes les cellules des deux premières lignes et colonnes de la feuille 1.
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 à 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 ou des caractères spéciaux.
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, s'il existe une plage nommée "Sheet1", Sheet1 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 contenant le nom de la feuille, ainsi que les coordonnées de la cellule de début et de fin à l'aide des numéros de ligne et de colonne. Cette méthode est moins courante que la notation A1, mais peut être utile pour faire référence à une plage de cellules par rapport à la position d'une cellule donnée.
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 actuelle.
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é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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/04 (UTC)."],[],[],null,["The Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
