Скрипт Google Apps Script, который загрузит данные из API сервиса в вашу 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

Об услуге

Заказы с платформы магазина, задачи из сервиса проектов, записи из системы бронирования: если у сервиса есть открытый API, данные могут попадать в вашу Google Таблицу без ручной выгрузки файлов. Этот скрипт Google Apps Script отправляет запрос к API с вашим собственным ключом, берёт нужные поля и записывает их строками, страницу за страницей. Начиная со «Стандарта» ключ хранится в свойствах скрипта, которые заполняете вы, а не в коде, а ошибки пишутся на лист «Журнал»; в «Премиуме» добавляются только новые и изменённые строки и есть инструкция, как запускать загрузку каждый час или день по триггеру. Пришлите ссылку на документацию API и нужные поля. Один запуск ограничен примерно шестью минутами, поэтому очень большие загрузки идут частями.

Что входит

• Что вы получитеАрхив ZIP с кодом Apps Script и README, где показано, как подключить его к таблице, вписать ключ и запустить; код также виден на странице заказа.
• По документацииНаписан по документации самого API
• Нужные поляТолько нужные столбцы, в вашем порядке
• Все страницыРезультаты, которые приходят страницами, читаются до конца
• Ключ не в кодеВы сами вписываете его в свойства скрипта
• Понятный кодС комментариями, поле легко добавить потом

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

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

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

Сервис и ссылка на документацию его API, нужный запрос (например, заказы за последние 30 дней) и поля, которые станут столбцами. Очень помогает пример ответа API: скопируйте его из документации или из пробного запроса, убрав личные значения. Как часто обновлять данные и дописывать ли новые строки или перезаписывать лист. Никогда не присылайте настоящий ключ API: в README показано, куда вы его впишете.

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

• Какой сервис и где документация его API?
• Какие данные нужны?
• Как часто обновлять?

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

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

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