Een Google Apps Script dat gegevens uit de API van een dienst in je Google-spreadsheet laadt en actueel houdt

Voorbeeldresultaat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Folder: sales/2026-10, 9 files found
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 rows
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 rows
2026-11-02 09:14:04 WARN  shop-07.csv: 3 rows without a price skipped (lines 88, 412, 913)
2026-11-02 09:14:05 INFO  Done: 10,412 rows -> report-2026-10.xlsx (sheets "Sales" and "Totals")

[columns]
date = Date, Sale date, Day
product = Product, Item, Name
quantity = Qty, Quantity, Pcs
price = Price, Unit price

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Reads one shop's file and gives it the report's column names."""
    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}: no column for '{name}' (looked for {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Over deze dienst

Bestellingen uit je webshopplatform, taken uit een projecttool, boekingen uit een reserveringssysteem: als de dienst een openbare API heeft, kunnen de gegevens in je Google-spreadsheet belanden zonder dat je met de hand bestanden exporteert. Dit Google Apps Script stuurt met je eigen sleutel een verzoek naar de API, pakt de velden die je nodig hebt en schrijft ze als rijen weg, pagina na pagina. Vanaf Standaard staat de sleutel in de eigenschappen van het script, die je zelf invult, niet in de code, en fouten gaan naar een tabblad Log; Premium voegt alleen nieuwe of gewijzigde rijen toe en geeft een handleiding om het met een trigger elk uur of elke dag te laten draaien. Stuur ons een link naar de documentatie van de API en de velden die je wilt. Eén run is beperkt tot ongeveer zes minuten, dus heel grote imports gaan in delen.

Wat is inbegrepen

• Wat je krijgtEen ZIP-archief met de Apps Script-code en een README die laat zien hoe je hem aan je spreadsheet toevoegt, je sleutel invult en hem uitvoert; de code staat ook op de bestelpagina.
• Volgens de documentatieGeschreven op basis van de eigen documentatie van de API
• Velden naar keuzeAlleen de kolommen die je nodig hebt, in jouw volgorde
• Alle pagina'sResultaten die in pagina's komen, worden tot het eind gelezen
• Sleutel buiten de codeJe zet hem zelf in de eigenschappen van het script
• Leesbare codeMet commentaar, later makkelijk een veld toe te voegen

Hoe het werkt

1. 1
   TaakJe stuurt de API-documentatie en de velden die je nodig hebt
2. 2
   CodeWij schrijven het script volgens de documentatie en de handleiding om het te installeren
3. 3
   UitproberenJe vult je sleutel in in een kopie van de spreadsheet en voert het uit
4. 4
   WijzigingenJe vraagt binnen je pakket om wijzigingen en stuurt een eventuele foutmelding mee

Wat we van je nodig hebben

De dienst en een link naar de API-documentatie, het verzoek dat je nodig hebt (bijvoorbeeld bestellingen van de afgelopen 30 dagen) en de velden die kolommen moeten worden. Een voorbeeld van het antwoord van de API helpt enorm: kopieer het uit de documentatie of uit een testaanroep met de privéwaarden verwijderd. Hoe vaak de gegevens moeten verversen en of er nieuwe rijen worden toegevoegd of de spreadsheet opnieuw wordt geschreven. Stuur nooit je echte API-sleutel: de README laat zien waar je die invult.

We vragen je:

• Welke dienst, en waar staat de API-documentatie?
• Welke gegevens heb je nodig?
• Hoe vaak moet het verversen?

Pakketten vergelijken

Vragen en antwoorden

Staat je antwoord er niet bij? Vraag het ons