Un Google Apps Script che copia i record tra la sua base Airtable e un foglio Google, in una direzione o in entrambe

Esempio di risultato

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Cartella: sales/2026-10, 9 file trovati
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 righe
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 righe
2026-11-02 09:14:04 WARN  shop-07.csv: saltate 3 righe senza prezzo (righe 88, 412, 913)
2026-11-02 09:14:05 INFO  Fatto: 10.412 righe -> report-2026-10.xlsx (fogli "Vendite" e "Totali")

[columns]
date = Data, Data vendita, Giorno
product = Prodotto, Articolo, Descrizione
quantity = Q.tà, Quantità, Pz
price = Prezzo, Prezzo unitario

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Legge il file di un negozio e gli dà i nomi di colonna del report."""
    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}: nessuna colonna per '{name}' (cercate: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Informazioni sul servizio

In un progetto alcune persone lavorano in Airtable, altre solo in Fogli Google, e copiare i record tra i due prima o poi va storto. Questo Google Apps Script legge la sua base Airtable tramite l'API ufficiale con il suo token di accesso personale e scrive in un foglio i record che sceglie: una tabella o una vista, i campi che le servono come colonne. Dallo Standard conserva l'ID del record in ogni riga, così una seconda esecuzione aggiorna le righe invece di duplicarle, e mostra i record collegati come nomi. Il Premium rimanda ad Airtable le modifiche fatte nel foglio, secondo la regola che imposta su quale lato prevale. Il suo token va nelle proprietà dello script, che compila lei, mai nel codice. Gira al ritmo consentito dall'API di Airtable; gli allegati arrivano come link.

Cosa è incluso

• Cosa riceveUn archivio ZIP con il codice Apps Script e un README che spiega come aggiungerlo al foglio, inserire il suo token ed eseguirlo; il codice è visibile anche nella pagina dell'ordine.
• API ufficialeLa Web API di Airtable con il suo token
• Campi a sua sceltaUna tabella o una vista, solo i campi che le servono
• Nessun doppioneDallo Standard, righe abbinate tramite l'ID del record
• Token fuori dal codiceLo inserisce lei nelle proprietà dello script
• Codice leggibileCon commenti, facile aggiungere un campo in seguito

Come funziona

1. 1
   CompitoLei descrive la base, le tabelle e la direzione
2. 2
   CodiceScriviamo lo script secondo la documentazione di Airtable e la guida all'installazione
3. 3
   Lo proviLo esegue su una copia della base o su una vista di prova
4. 4
   ModificheChiede modifiche nei limiti del pacchetto e invia eventuali messaggi di errore

Cosa ci serve da lei

Le tabelle o viste di Airtable da sincronizzare e uno screenshot dei loro campi con i tipi (testo, numero, data, selezione singola, record collegato, allegato), il foglio di destinazione e come devono chiamarsi e ordinarsi le colonne. Quale direzione le serve e, per la sincronizzazione bidirezionale (Premium), quale lato prevale quando lo stesso record cambia in entrambi i posti. Ogni quanto deve essere eseguito. Crei il token di accesso personale nel suo account Airtable; non lo invii mai a noi.

Le chiederemo:

• Cosa c'è nella base Airtable?
• Quale direzione le serve?
• Quali campi devono essere copiati?
• Ogni quanto deve essere eseguito?

Confronto dei pacchetti

Domande e risposte

Non hai trovato la risposta? Chiedi a noi