Bir servisin API'sinden Google E-Tablolar dosyanıza veri yükleyen ve onu güncel tutan bir Google Apps Script

Örnek sonuç

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

Bu hizmet hakkında

Mağaza platformunuzdan siparişler, bir proje servisinden görevler, bir rezervasyon sisteminden kayıtlar: servisin herkese açık bir API'si varsa veriler, dosyaları elle dışa aktarmadan Google E-Tablolar dosyanıza gelebilir. Bu Google Apps Script kendi anahtarınızla API'ye bir istek gönderir, ihtiyacınız olan alanları alır ve sayfa sayfa satırlar olarak yazar. Standart paketten itibaren anahtar kodda değil, sizin doldurduğunuz betik özelliklerinde durur ve hatalar bir Log sekmesine gider; Premium yalnızca yeni ya da değişen satırları ekler ve bir tetikleyiciyle her saat ya da her gün çalıştırmak için bir kılavuz sunar. Bize API dokümantasyonunun bağlantısını ve istediğiniz alanları gönderin. Tek bir çalıştırma yaklaşık altı dakikayla sınırlıdır, bu yüzden çok büyük aktarımlar parça parça yapılır.

Neler dahil

• Neler alırsınızApps Script kodunu ve onu tablonuza nasıl ekleyeceğinizi, anahtarınızı nasıl gireceğinizi ve nasıl çalıştıracağınızı gösteren bir README dosyasını içeren bir ZIP arşivi; kod sipariş sayfasında da gösterilir.
• Dokümantasyona göreAPI'nin kendi dokümantasyonundan yazılır
• Sizin seçtiğiniz alanlarYalnızca ihtiyacınız olan sütunlar, sizin sıranızla
• Tüm sayfalarSayfalar hâlinde gelen sonuçlar sonuna kadar okunur
• Anahtar kodun dışında tutulurOnu betik özelliklerine kendiniz girersiniz
• Okunabilir kodYorumlarla; sonradan alan eklemek kolay

Nasıl çalışır

1. 1
   GörevAPI dokümantasyonunu ve ihtiyacınız olan alanları gönderirsiniz
2. 2
   KodBetiği dokümantasyona göre ve kurulum kılavuzunu yazarız
3. 3
   DeneyinTablonun bir kopyasına anahtarınızı ekler ve çalıştırırsınız
4. 4
   DeğişikliklerPaketiniz kapsamında değişiklik ister, varsa hata mesajını gönderirsiniz

Sizden neler gerekiyor

Servis ve API dokümantasyonunun bağlantısı, ihtiyacınız olan istek (örneğin son 30 günün siparişleri) ve sütun olması gereken alanlar. API'nin cevabından bir örnek çok yardımcı olur: dokümantasyondan ya da özel değerleri çıkarılmış bir deneme çağrısından kopyalayın. Verilerin ne sıklıkla yenileneceği ve yeni satırların ekleneceği mi yoksa tablonun yeniden mi yazılacağı. Gerçek API anahtarınızı asla göndermeyin: README onu nereye koyacağınızı gösterir.

Size soracaklarımız:

• Hangi servis ve API dokümantasyonu nerede?
• Hangi verilere ihtiyacınız var?
• Ne sıklıkla yenilenmeli?

Paketleri karşılaştırın

Sorular ve yanıtlar

Yanıtınızı bulamadınız mı? Bize sorun