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

Об услуге

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

Что входит

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

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

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

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

Таблицы или представления Airtable для синхронизации и скриншот их полей с типами (текст, число, дата, выбор из списка, связанная запись, вложение), лист, куда они идут, и как называть и упорядочить столбцы. Какое нужно направление и, для двусторонней синхронизации («Премиум»), чья сторона главнее, если одна запись изменилась в двух местах. Как часто запускать. Личный токен доступа создайте в своём аккаунте Airtable и никогда не присылайте нам.

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

• Что в базе Airtable?
• Какое нужно направление?
• Какие поля переносить?
• Как часто запускать?

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

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

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