Un Google Apps Script che carica nel suo foglio Google i dati dall'API di un servizio e li tiene aggiornati

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

Ordini dalla piattaforma del suo negozio, attività da un servizio di gestione progetti, voci da un sistema di prenotazione: se il servizio ha un'API pubblica, i dati possono arrivare nel suo foglio Google senza esportare file a mano. Questo Google Apps Script invia una richiesta all'API con la sua chiave, prende i campi che le servono e li scrive come righe, pagina dopo pagina. Dallo Standard la chiave sta nelle proprietà dello script, che compila lei, non nel codice, e gli errori finiscono in una scheda Log; il Premium aggiunge solo le righe nuove o modificate e una guida per eseguirlo ogni ora o ogni giorno con un attivatore. Ci invii un link alla documentazione dell'API e i campi che desidera. Una singola esecuzione è limitata a circa sei minuti, quindi le importazioni molto grandi vanno fatte a blocchi.

Cosa è incluso

• Cosa riceveUn archivio ZIP con il codice Apps Script e un README che spiega come aggiungerlo al foglio, inserire la sua chiave ed eseguirlo; il codice è visibile anche nella pagina dell'ordine.
• Secondo la documentazioneScritto in base alla documentazione dell'API
• Campi a sua sceltaSolo le colonne che le servono, nel suo ordine
• Tutte le pagineI risultati divisi in pagine vengono letti fino alla fine
• Chiave fuori dal codiceLa inserisce lei nelle proprietà dello script
• Codice leggibileCon commenti, facile aggiungere un campo in seguito

Come funziona

1. 1
   CompitoLei invia la documentazione dell'API e i campi che le servono
2. 2
   CodiceScriviamo lo script secondo la documentazione e la guida all'installazione
3. 3
   Lo proviAggiunge la sua chiave in una copia del foglio e lo esegue
4. 4
   ModificheChiede modifiche nei limiti del pacchetto e invia eventuali messaggi di errore

Cosa ci serve da lei

Il servizio e un link alla documentazione della sua API, la richiesta che le serve (per esempio gli ordini degli ultimi 30 giorni) e i campi che devono diventare colonne. Un esempio di risposta dell'API aiuta molto: lo copi dalla documentazione o da una chiamata di prova, togliendo i valori privati. Ogni quanto devono aggiornarsi i dati e se aggiungere righe nuove o riscrivere il foglio. Non invii mai la sua vera chiave API: il README spiega dove inserirla.

Le chiederemo:

• Quale servizio, e dov'è la documentazione della sua API?
• Quali dati le servono?
• Ogni quanto deve aggiornarsi?

Confronto dei pacchetti

Domande e risposte

Non hai trovato la risposta? Chiedi a noi