Un Google Apps Script qui charge les données de l’API d’un service dans votre feuille Google Sheets et les tient à jour

Exemple de résultat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Dossier : sales/2026-10, 9 fichiers trouvés
2026-11-02 09:14:03 INFO  shop-01.csv : 1 284 lignes
2026-11-02 09:14:04 INFO  shop-02.xlsx : 967 lignes
2026-11-02 09:14:04 WARN  shop-07.csv : 3 lignes sans prix ignorées (lignes 88, 412, 913)
2026-11-02 09:14:05 INFO  Terminé : 10 412 lignes -> report-2026-10.xlsx (feuilles « Ventes » et « Totaux »)

[columns]
date = Date, Date de vente, Jour
product = Produit, Article, Désignation
quantity = Qté, Quantité, Pièces
price = Prix, Prix unitaire

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lit le fichier d’une boutique et lui donne les noms de colonnes du rapport."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name} : aucune colonne pour '{name}' (recherché : {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

À propos de ce service

Les commandes de votre plateforme de boutique, les tâches d’un outil de gestion de projet, les réservations d’un système de booking : si le service a une API publique, les données peuvent arriver dans votre feuille Google Sheets sans exporter de fichiers à la main. Ce Google Apps Script envoie une requête à l’API avec votre propre clé, récupère les champs voulus et les écrit en lignes, page après page. Dès Standard, la clé se trouve dans les propriétés du script, que vous remplissez vous-même, et non dans le code, et les erreurs vont dans un onglet Journal ; Premium n’ajoute que les lignes nouvelles ou modifiées et fournit un guide pour le lancer toutes les heures ou tous les jours avec un déclencheur. Envoyez-nous le lien vers la documentation de l’API et les champs voulus. Une exécution est limitée à environ six minutes : les très gros imports se font en plusieurs fois.

Ce qui est inclus

• Ce que vous recevezUne archive ZIP avec le code Apps Script et un README qui montre comment l’ajouter à votre feuille, saisir votre clé et le lancer ; le code est aussi affiché sur la page de la commande.
• D’après la documentationÉcrit à partir de la documentation de l’API elle-même
• Champs au choixUniquement les colonnes voulues, dans votre ordre
• Toutes les pagesLes résultats paginés sont lus jusqu’au bout
• Clé hors du codeVous la saisissez vous-même dans les propriétés du script
• Code lisibleAvec des commentaires, pour ajouter facilement un champ plus tard

Comment ça marche

1. 1
   TâcheVous envoyez la documentation de l’API et les champs voulus
2. 2
   CodeNous écrivons le script d’après la documentation et le guide d’installation
3. 3
   Testez-leVous ajoutez votre clé dans une copie de la feuille et le lancez
4. 4
   RetouchesVous demandez des retouches selon votre formule et envoyez les éventuels messages d’erreur

Ce dont nous avons besoin

Le service et un lien vers la documentation de son API, la requête voulue (par exemple les commandes des 30 derniers jours) et les champs qui deviennent des colonnes. Un exemple de réponse de l’API aide beaucoup : copiez-le depuis la documentation ou depuis un appel de test, valeurs privées retirées. La fréquence d’actualisation et s’il faut ajouter de nouvelles lignes ou réécrire la feuille. N’envoyez jamais votre vraie clé API : le README montre où la saisir.

Nous vous demanderons :

• Quel service, et où est la documentation de son API ?
• De quelles données avez-vous besoin ?
• À quelle fréquence actualiser ?

Comparer les formules

Questions et réponses

Vous n’avez pas trouvé la réponse ? Posez-nous la question