Cette section contient un atelier de programmation que vous pouvez utiliser pour vous familiariser avec l'API Google Sheets. Un ensemble d'exemples de "recettes" est également fourni pour illustrer comment traduire une action Google Sheets souhaitée en requête API.
Il existe souvent plusieurs façons d'effectuer une tâche donnée avec l'API. Lorsque vous choisissez l'approche à adopter pour une tâche, tenez compte des points suivants:
- Si vous devez lire ou écrire des valeurs de cellule, la collection
spreadsheets.valuesest un meilleur choix que la collectionspreadsheets. L'interface de l'ancien outil est plus facile à utiliser pour les opérations de lecture/écriture simples. Dans la mesure du possible, utilisez les méthodes de traitement par lot (
spreadsheet.batchUpdate,spreadsheet.values.batchGetetspreadsheet.values.batchUpdate) pour regrouper plusieurs requêtes en un seul appel de méthode. Ces méthodes de traitement par lot améliorent l'efficacité, car elles:- Réduisez la surcharge HTTP du client.
- Réduisez le nombre de requêtes effectuées.
- Réduisez le nombre de révisions sur le document.
- Assurez-vous de l'atomicité de toutes les modifications du lot.
Recettes
Les exemples présentés dans cette section montrent comment exprimer des actions courantes dans Sheets sous forme de requêtes API v4.
Ces exemples se présentent sous la forme de requêtes HTTP neutres en termes de langage. 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 de l'API Google, consultez les guides Lire et écrire les valeurs des cellules de lecture et Mettre à jour les feuilles de calcul.
Dans cette section, les recettes sont divisées en catégories:
- Lecture de base : recettes indiquant comment lire les valeurs d'une feuille de calcul.
- Écriture de base : recettes qui montrent comment écrire des valeurs dans une feuille de calcul.
- Mise en forme de base : recettes indiquant comment modifier l'apparence des feuilles et des cellules.
- Graphiques : recettes montrant comment créer et modifier des graphiques dans une feuille de calcul.
- Mise en forme conditionnelle : recettes montrant comment modifier l'apparence des cellules en fonction de certaines conditions.
- Opérations sur les données : recettes indiquant comment créer, déplacer et manipuler des données dans une feuille de calcul.
- Plages nommées et protégées : recettes indiquant 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 montrant comment créer des tableaux croisés dynamiques dans une feuille de calcul.
- Opérations sur les lignes et les colonnes : recettes pour ajouter, supprimer et déplacer des lignes et des colonnes, et mettre à jour leurs propriétés.
- Opérations sur les feuilles : recettes indiquant comment créer, effacer, copier et supprimer des feuilles, et contrôler leurs propriétés.