Un Google Apps Script qui copie les enregistrements entre votre base Airtable et une feuille Google Sheets, dans un sens ou dans les deux

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

Sur un projet, certains travaillent dans Airtable, d’autres uniquement dans Google Sheets, et recopier les enregistrements de l’un à l’autre finit toujours par déraper. Ce Google Apps Script lit votre base Airtable via son API officielle avec votre propre jeton d’accès personnel et écrit les enregistrements choisis dans une feuille : une table ou une vue, les champs voulus en colonnes. Dès Standard, il garde l’identifiant de l’enregistrement dans chaque ligne, pour qu’un second lancement mette les lignes à jour au lieu de les dupliquer, et affiche les enregistrements liés par leur nom. Premium renvoie les modifications de la feuille vers Airtable selon la règle que vous fixez pour le côté prioritaire. Votre jeton va dans les propriétés du script, que vous remplissez, jamais dans le code. Il tourne au rythme permis par l’API d’Airtable ; les pièces jointes arrivent sous forme de liens.

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 jeton et le lancer ; le code est aussi affiché sur la page de la commande.
• API officielleLa Web API d’Airtable avec votre jeton
• Champs au choixUne table ou une vue, uniquement les champs voulus
• Aucun doublonDès Standard, lignes associées par identifiant d’enregistrement
• Jeton hors du codeVous le saisissez 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 décrivez la base, les tables et le sens de synchronisation
2. 2
   CodeNous écrivons le script d’après la documentation d’Airtable et le guide d’installation
3. 3
   Testez-leVous le lancez sur une copie de la base ou une vue de test
4. 4
   RetouchesVous demandez des retouches selon votre formule et envoyez les éventuels messages d’erreur

Ce dont nous avons besoin

Les tables ou vues Airtable à synchroniser et une capture de leurs champs avec leurs types (texte, nombre, date, sélection unique, enregistrement lié, pièce jointe), la feuille de destination et le nom et l’ordre des colonnes. Le sens voulu et, pour une synchronisation dans les deux sens (Premium), le côté prioritaire quand un même enregistrement change des deux côtés. La fréquence de lancement. Créez le jeton d’accès personnel dans votre compte Airtable ; ne nous l’envoyez jamais.

Nous vous demanderons :

• Que contient la base Airtable ?
• Quel sens vous faut-il ?
• Quels champs reprendre ?
• À quelle fréquence le lancer ?

Comparer les formules

Questions et réponses

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