Exemples
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette section présente un codelab que vous pouvez utiliser pour vous familiariser avec l'API Google Sheets. Vous trouverez également un ensemble d'exemples de "recettes" qui montrent comment traduire une action Google Sheets prévue en requête API.
Il existe souvent plusieurs façons d'accomplir une tâche donnée avec l'API. Lorsque vous décidez de la manière d'aborder une tâche, gardez les points suivants à l'esprit :
- Si vous devez lire ou écrire des valeurs de cellules, la collection
spreadsheets.values est un meilleur choix que la collection spreadsheets. L'interface de la première est plus facile à utiliser pour les opérations de lecture/écriture simples.
Dans la mesure du possible, utilisez les méthodes par lots (spreadsheet.batchUpdate, spreadsheet.values.batchGet et spreadsheet.values.batchUpdate) pour regrouper plusieurs requêtes en un seul appel de méthode. L'utilisation de ces méthodes par lot améliore l'efficacité, car elles :
- Réduisez les frais généraux HTTP du client.
- Réduisez le nombre de requêtes effectuées.
- Réduisez le nombre de révisions du document.
- Assurez-vous que toutes les modifications du lot sont atomiques.
Recettes
Les exemples listés dans cette section montrent comment exprimer des actions courantes dans Sheets en tant que requêtes Sheets API v4.
Ces exemples sont présentés sous la forme de requêtes HTTP pour être neutres en termes de langue. Pour découvrir comment implémenter les protocoles de requête de l'API Sheets dans un langage spécifique à l'aide des bibliothèques clientes des API Google, consultez les guides Lire et écrire des valeurs de cellules et Mettre à jour des feuilles de calcul.
Les recettes de cette section sont divisées en plusieurs catégories :
- Lecture de base : recettes qui montrent comment lire les valeurs d'une feuille.
- Écriture de base : recettes qui montrent comment écrire des valeurs dans une feuille.
- Mise en forme de base : recettes qui montrent comment modifier l'apparence des feuilles et des cellules.
- Graphiques : recettes qui montrent comment créer et modifier des graphiques dans une feuille.
- Mise en forme conditionnelle : recettes qui montrent comment modifier l'apparence des cellules en fonction de conditions.
- Opérations sur les données : recettes qui montrent comment créer, déplacer et manipuler des données dans une feuille de calcul.
- Plages nommées et protégées : recettes qui montrent comment créer, modifier et supprimer des plages nommées et protégées dans une feuille de calcul.
- Tableaux croisés dynamiques : recettes qui expliquent comment créer des tableaux croisés dynamiques dans une feuille de calcul.
- Opérations sur les lignes et les colonnes : recettes qui montrent comment ajouter, supprimer et déplacer des lignes et des colonnes, et comment mettre à jour leurs propriétés.
- Opérations sur les feuilles : recettes qui montrent comment créer, vider, copier et supprimer des feuilles, et comment contrôler leurs propriétés.
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/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Samples\n\nThis section presents a\n[codelab](https://codelabs.developers.google.com/codelabs/sheets-api/) you can\nuse to become familiar with the Google Sheets API. Also provided are a set of\n\"recipe\" examples that demonstrate how to translate an intended Google Sheets\naction into an API request.\n\nOften there's more than one way to complete a given task with the API. When\nyou're deciding on how to approach a task, keep the following in mind:\n\n- If you need to read or write cell values, the [`spreadsheets.values`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values) collection is a better choice than the [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets) collection. The former's interface is easier to use for simple read/write operations.\n- Wherever possible, use the batch methods\n ([`spreadsheet.batchUpdate`](/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate),\n [`spreadsheet.values.batchGet`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet),\n and\n [`spreadsheet.values.batchUpdate`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate))\n to bundle multiple requests into a single method call. Using these batch\n methods improves efficiency as they:\n\n - Reduce client HTTP overhead.\n - Reduce the number of queries made.\n - Reduce the number of revisions on the doc.\n - Ensure atomicity of all the changes in the batch.\n\nRecipes\n-------\n\nThe examples listed in this section demonstrate how to express common actions in\nSheets as Sheets API v4 requests.\n\nThese examples are presented in the form of HTTP requests to be language\nneutral. To learn how to implement Sheets API request protocols in a\nspecific language using Google API client libraries, see the [Read \\& write cell\nvalues](/workspace/sheets/api/guides/values) and [Update\nspreadsheets](/workspace/sheets/api/guides/batchupdate) guides.\n\nRecipes in this section are divided into the following categories:\n\n- [Basic reading](/workspace/sheets/api/samples/reading)---Recipes that show how to read values from a sheet.\n- [Basic writing](/workspace/sheets/api/samples/writing)---Recipes that show how to write values to a sheet.\n- [Basic formatting](/workspace/sheets/api/samples/formatting)---Recipes that show how to change the appearance of sheets and cells.\n- [Charts](/workspace/sheets/api/samples/charts)---Recipes that show how to create and alter charts in a sheet.\n- [Conditional formatting](/workspace/sheets/api/samples/conditional-formatting)--- Recipes that show how to alter cell appearance based on conditions.\n- [Data operations](/workspace/sheets/api/samples/data)---Recipes that show how to create, move, and manipulate data in a spreadsheet.\n- [Named \\& protected\n ranges](/workspace/sheets/api/samples/ranges)---Recipes that show how to create, update, and remove named and protected ranges in a spreadsheet.\n- [Pivot tables](/workspace/sheets/api/samples/pivot-tables)---Recipes that show how to create pivot tables in a sheet.\n- [Row \\& column\n operations](/workspace/sheets/api/samples/rowcolumn)---Recipes that show how to add, remove, and move rows and columns, and update their properties.\n- [Sheet operations](/workspace/sheets/api/samples/sheet)---Recipes that show how to create, clear, copy, and delete sheets, and also control their properties."]]
