外部サービスのAPIからGoogle スプレッドシートにデータを読み込み、最新に保つGoogle Apps Script

実行の仕方

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  フォルダ：sales/2026-10、ファイル9件を検出
2026-11-02 09:14:03 INFO  shop-01.csv：1,284行
2026-11-02 09:14:04 INFO  shop-02.xlsx：967行
2026-11-02 09:14:04 WARN  shop-07.csv：価格のない3行をスキップ（88行目、412行目、913行目）
2026-11-02 09:14:05 INFO  完了：10,412行 -> report-2026-10.xlsx（シート「売上」と「合計」）

コードではなく設定で

各店舗の列名は settings.ini にまとめてあるので、店舗が増えたり列名が変わったりしても、そこに1行加えるだけです。

[columns]
date = 日付, 販売日, 売上日
product = 商品, 品名, 商品名
quantity = 数量, 個数, 点数
price = 価格, 単価

コードの一部

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """1店舗分のファイルを読み込み、レポートの列名に合わせます。"""
    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}：'{name}' に当たる列がありません（探した列名：{', '.join(variants)}）")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

ファイル： merge_sales.py（310行）、settings.ini、requirements.txt、そしてPythonのインストール方法、スクリプトの実行方法、ログの各メッセージの意味を説明したREADMEを含むZIPファイル。お客様ご自身のパソコンで実行していただきます。