Скрипт Google Apps Script, который сохранит вложения из вашего Gmail в папки Google Диска по отправителю, дате или типу

Пример результата

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: 1284 строки
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 (листы «Продажи» и «Итоги»)

[columns]
date = Дата, Дата продажи, День
product = Товар, Наименование, Название
quantity = Кол-во, Количество, Шт
price = Цена, Цена за шт

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Читает файл одного магазина и даёт столбцам названия из отчёта."""
    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

Об услуге

Счета поставщиков, подписанные документы, еженедельные отчёты: когда вложения остаются в Gmail, найти нужное потом можно только перебирая переписку. Этот скрипт Google Apps Script проходит по письмам, которые вы выбрали поиском Gmail, например от поставщиков с PDF, и сохраняет каждое вложение в папку Google Диска: в одну папку или в подпапки по отправителю, месяцу или типу файла, с именами, где есть дата и отправитель. Потом он ставит письму метку «Сохранено», чтобы ничего не сохранялось дважды, а начиная со «Стандарта» записывает каждый файл в журнал. Мелкие картинки из подписей можно не сохранять. Файлы занимают место на вашем Диске. Запуск ограничен примерно шестью минутами, поэтому большой накопившийся объём идёт частями. Ставите и запускаете скрипт вы в своём аккаунте Google.

Что входит

• Что вы получитеАрхив ZIP с кодом Apps Script и README, где показано, как подключить его к аккаунту, дать доступ и запустить; код также виден на странице заказа.
• Письма через поиск Gmailнапример, from:@supplier.example has:attachment
• Папки как нужноОдна папка или по отправителю, месяцу, типу
• Понятные именаК имени добавляются дата и отправитель
• Ничего дваждыСохранённые письма получают метку и в следующий раз пропускаются
• Понятный кодС комментариями, папку легко добавить потом

Порядок работы

1. 1
   ЗадачаВы описываете, какие письма брать и как раскладывать по папкам
2. 2
   КодМы пишем скрипт и инструкцию по установке
3. 3
   ПроверкаВы запускаете его сначала на узком поиске и проверяете папку
4. 4
   ПравкиВы просите правки в рамках пакета и присылаете текст ошибки, если она есть

Что нужно от вас

Какие письма брать: отправители или домены, слова в теме, типы файлов, период или поиск Gmail, которым вы уже пользуетесь. Как устроить и назвать папки на Диске, как называть файлы и что пропускать (картинки из подписей, файлы меньше определённого размера). Примерно сколько писем с вложениями есть сейчас и как часто приходят новые и пользуетесь ли вы бесплатным Gmail или Google Workspace.

В брифе мы спросим:

• Какие вложения нужны?
• Как разложить по папкам?
• Как называть файлы?
• И старые письма, и как часто?

Сравнение пакетов

Вопросы и ответы

Не нашли ответ? Спросите