Техническое задание: Автоматизация работы с маркетплейсом

Цель проекта

Создать автоматизированное решение на Google Apps Script для двустороннего взаимодействия с API маркетплейса Wildberries и Google Таблиц.

Основные функции

1. Загрузка обложек товаров

• Автоматическая ночная загрузка одной обложки (изображения по URL) в карточку товара на маркетплейсе.
• Каждый лист таблицы соответствует одному товару (nmId).

2. Система логирования

• Краткий лог результатов операции сохраняется в листе соответствующего товара.
• Полный лог с детализацией всех операций ведется в отдельном листе «Лог».
• В логе хранятся последние 200 записей.

3. Сбор ежедневной статистики

• Автоматический сбор ключевых метрик: просмотры, клики, CTR, добавления в корзину, заказы, суммы, конверсии, остатки на складе.
• Данные собираются за дату, указанную в колонке D таблицы, по заданному условию.
• Результаты записываются в соответствующие листы.

Технические требования

Работа с API

• Строгое соблюдение ограничений API маркетплейса: burst = 5 запросов, пополнение лимита каждые 600 мс (~100 запросов в минуту).
• Обязательная реализация алгоритма Token Bucket для управления частотой запросов.
• Реализация механизма повторных попыток (retries) при ошибках.
• Защита от параллельного выполнения скрипта.

Архитектура и код

• Решение должно быть реализовано на Google Apps Script.
• Код должен быть структурированным, с комментариями и обработкой ошибок.
• Необходимо обеспечить надежность и стабильность работы при длительных операциях.