Перейти на сайт

Экспорт отзывов, API

Выгружайте отзывы о товарах для задач по синхронизации контента, индексации, отчетов, аналитики и прочих задач.

Используйте для выгрузки Platform API, метод "Задачи на экспорт".


Порядок действий для экспорта отзывов:

  1. Создать задачу на экспорт отзывов с "records_type": "reviews"

  2. Каждую минуту проверять статус задачи

  3. Если статус задачи изменился на completed

  4. Скачать файл по предоставленной ссылке

  5. При необходимости, создать новую задачу на экспорт, если нужно экспортировать большой объем данных (возвращаемся на п. 1 и повторяем цикл, и так пока не экспортируете весь объем данных)

Рекомендации:

- Если экспорт отзывов вам необходим для периодической синхронизации данных с вашими системами, экспортируйте данные не чаще чем раз в сутки. Если синхронизация данных необходима чаще чем раз в сутки, используйте вебхуки, вместо экспортов (см. эту статью)

Комментарии:

- Отзывы из внешних источников, полученные по услуге агрегации, по умолчанию не попадают в экспорты, если иного не предусмотрено в вашем тарифе, в условиях договора. Для подключения услуги обратитесь к менеджеру Aplaut

- Чтобы не экспортировать каждый раз все отзывы, ускорить выгрузку и не выходить за лимиты, используйте "search_options" и экспортируйте только обновления отзывов. Для этого добавьте фильтр — товары, обновленные за временной отрезок (если у вас задача периодически обновлять данные, оптимально делать выгрузки с периодичностью раз в сутки*):

"search_options": {
     "filter": {
          "updated_at":{
          "gt": "YYYY-MM-DDThh:mm:ss+03:00"
          }
     }
}

- Для различных задач могут потребоваться и другие фильтры, примеры атрибутов ищите в описании метода по коллекции "Отзывы" в списке атрибутов, а доступные операторы в разделе Фильтрация

- Для ограничения или расширения кол-ва данных которые будут присутствовать в файле выгрузки, в форматах CSV или XLSX, используйте "export_format" и настройку формата экспорта данных. Можно скопировать из личного кабинета и подкорректировать набор. Пример такого фильтра:

"export_format": "[.id?, .created_at?, .state?, .order_number?, .context_type?, .product_id?, .product.name?, .product.url?, .category.name?, .brand.name?, .location_name?, .rating?, .body?, .pros?, .cons?, .recommended?, .likes?, .dislikes?]"

Лимиты и ограничения:

Существует ежедневный лимит на длительность всех успешно завершенных экспортов — 60 минут. При превышении этой квоты все новые экспорты будут отменены, или помещены в очередь с низким приоритетом, и экспорты будут выполняться медленно. Ограничения общие для всех добавленных аккаунтов в ЛК, и действуют до начала следующего дня.

Например, в течение дня были сделаны 3 выгрузки. Первая выгрузка выполнялась 20 минут, вторая 30, а третья — 15. Суммарно выгрузки для компании готовились 65 минут. Поэтому, следующая выгрузка возможна с высоким приоритетом возможна только на следующий календарный день, а все новые экспорты за текущий день будут помещены в очередь с низким приоритетом и выполняться сильно дольше.


Также существует лимит по кол-ву строк / единиц контента (отзыв, товар, вопрос, ответ и т.д.) — 500 000 строк за один экспорт. Если необходимо выгрузить больше единиц контента, выгрузку нужно разбить на части, например по временным отрезкам, или другим параметрам, воспользовавшись быстрыми фильтрами или продвинутым поиском, при выгрузке из ЛК, либо фильтрацией, при выгрузке через Platform API.


Ограничения распространяются на задачи всей компании, созданные как через ЛК, так и через Platform API.

Еще:

👆 На этом пока всё