Cette section présente un atelier de programmation 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 une requête API.
Il existe souvent plusieurs façons d'effectuer 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
spreadsheets.valuescollection est un meilleur choix que laspreadsheetscollection. 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, etspreadsheet.values.batchUpdate) pour regrouper plusieurs requêtes en un seul appel de méthode. L'utilisation de ces méthodes par lots améliore l'efficacité, car elles :- réduisent la surcharge HTTP du client ;
- réduisent le nombre de requêtes effectuées ;
- réduisent le nombre de révisions du document ;
- garantissent l'atomicité de toutes les modifications du lot.
Recettes
Les exemples listés dans cette section montrent comment exprimer des actions courantes dans Sheets en tant que requêtes de l'API Sheets v4.
Ces exemples sont présentés sous la forme de requêtes HTTP pour être indépendants du langage. Pour découvrir comment implémenter des protocoles de requête API de l'API Sheets dans un langage spécifique à l'aide des bibliothèques clientes de l'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 des valeurs à partir 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, mettre à jour et supprimer des plages nommées et protégées dans une feuille de calcul.
- Tableaux croisés dynamiques : recettes qui montrent comment créer des tableaux croisés dynamiques dans une feuille.
- 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, effacer, copier et supprimer des feuilles, et comment contrôler leurs propriétés.