Skrypt Google Apps Script, który pobiera dane z API serwisu do Twojego Arkusza Google i dba o ich aktualność

Przykładowy rezultat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Folder: sales/2026-10, znaleziono 9 plików
2026-11-02 09:14:03 INFO  shop-01.csv: 1284 wiersze
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 wierszy
2026-11-02 09:14:04 WARN  shop-07.csv: pominięto 3 wiersze bez ceny (linie 88, 412, 913)
2026-11-02 09:14:05 INFO  Gotowe: 10 412 wierszy -> report-2026-10.xlsx (arkusze „Sprzedaż” i „Podsumowanie”)

[columns]
date = Data, Data sprzedaży, Dzień
product = Produkt, Towar, Nazwa
quantity = Ilość, Szt., Liczba sztuk
price = Cena, Cena jedn.

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Wczytuje plik jednego sklepu i nadaje mu nazwy kolumn raportu."""
    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}: brak kolumny dla '{name}' (szukano: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

O usłudze

Zamówienia z platformy sklepu, zadania z serwisu do projektów, wpisy z systemu rezerwacji: jeśli serwis ma publiczne API, dane mogą trafiać do Twojego Arkusza Google bez ręcznego eksportowania plików. Ten skrypt Google Apps Script wysyła zapytanie do API z Twoim własnym kluczem, wybiera potrzebne pola i zapisuje je jako wiersze, strona po stronie. Od pakietu Standard klucz jest przechowywany we właściwościach skryptu, które wypełniasz sam, a nie w kodzie, a błędy trafiają na kartę Log; pakiet Premium dodaje tylko nowe lub zmienione wiersze i instrukcję uruchamiania co godzinę lub codziennie za pomocą wyzwalacza. Prześlij nam link do dokumentacji API i pola, których potrzebujesz. Jedno uruchomienie jest ograniczone do około sześciu minut, więc bardzo duże importy przebiegają w częściach.

Co obejmuje usługa

• Co otrzymaszArchiwum ZIP z kodem Apps Script i plikiem README, który pokazuje, jak dodać go do arkusza, wpisać klucz i uruchomić; kod widać też na stronie zamówienia.
• Według dokumentacjiNapisany na podstawie dokumentacji samego API
• Wybrane przez Ciebie polaTylko potrzebne kolumny, w Twojej kolejności
• Wszystkie stronyWyniki przychodzące stronami są odczytywane do końca
• Klucz poza kodemWpisujesz go sam we właściwościach skryptu
• Czytelny kodZ komentarzami, łatwo później dodać pole

Jak to działa

1. 1
   ZadaniePrzysyłasz dokumentację API i potrzebne pola
2. 2
   KodPiszemy skrypt według dokumentacji i instrukcję instalacji
3. 3
   WypróbujDodajesz swój klucz w kopii arkusza i uruchamiasz skrypt
4. 4
   ZmianyZgłaszasz poprawki w ramach pakietu i przesyłasz ewentualny komunikat o błędzie

Czego potrzebujemy od Ciebie

Serwis i link do jego dokumentacji API, potrzebne zapytanie (na przykład zamówienia z ostatnich 30 dni) i pola, które mają stać się kolumnami. Bardzo pomaga przykładowa odpowiedź API: skopiuj ją z dokumentacji lub z testowego wywołania, usuwając prywatne wartości. Jak często dane mają się odświeżać i czy nowe wiersze mają być dopisywane, czy arkusz ma być nadpisywany. Nigdy nie przesyłaj prawdziwego klucza API: README pokazuje, gdzie go wpisać.

Zapytamy Cię:

• Jaki serwis i gdzie jest jego dokumentacja API?
• Jakich danych potrzebujesz?
• Jak często mają się odświeżać?

Porównaj pakiety

Pytania i odpowiedzi

Nie ma tu odpowiedzi? Zapytaj nas