Экспорт вопросов и ответов, API

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

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

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

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

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

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

Подробнее читайте в документации.

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

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

 "search_options": {
      "filter": {
           "updated_at":{
                "gt": "YYYY-MM-DDThh:mm:ss+03:00"
                }
           }
      } 
  • Для различных задач могут потребоваться и другие фильтры, примеры атрибутов ищите в описании метода по коллекции "Вопросы и ответы" в списке атрибутов, доступные операторы в разделе Фильтрация

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

     "export_format": "unwind(.answers) | [.id?, .created_at?, .updated_at?, .product_id?, .category.name?, .author_name?, .author_email?, .body?, .answers._id?, .answers.text?]"

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

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

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

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

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


Еще:

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