Файл отзывов для саммаризации

Shopping Assistant может использовать отзывы покупателей, чтобы формировать краткое саммари по товару: выделять основные достоинства, недостатки и повторяющиеся мнения. Для первоначальной загрузки подготовьте полный файл с актуальным состоянием отзывов и разместите его по ссылке, доступной для скачивания Gravity Field.

Файл должен быть сохранен в кодировке UTF-8 и соответствовать стандарту CSV RFC 4180. XML и другие форматы в универсальный контракт не входят.

Формат файла

Первая строка файла должна содержать названия колонок в указанном порядке:

reviewId,sku,rating,title,text,pros,cons,status,helpfulCount,locale,createdAt,updatedAt

Пример:

reviewId,sku,rating,title,text,pros,cons,status,helpfulCount,locale,createdAt,updatedAt
rv-123,sku-456,5,Отличный крем,"Быстро впитывается, хорошо увлажняет",Текстура,Сильный запах,published,12,ru-RU,2026-08-20T09:00:00Z,2026-08-31T10:00:00Z
rv-124,sku-789,4,,Подошел для сухой кожи,,,published,,ru-RU,2026-08-21T12:30:00Z,2026-08-21T12:30:00Z

Описание полей

Поля title, text, pros и cons могут быть пустыми. Отзывы только с оценкой допустимы, но не участвуют в текстовой саммаризации.

Для саммаризации используются только отзывы со статусом published. Отзывы со статусами hidden и deleted исключаются из обработки.

Правила заполнения CSV

• Используйте запятую , как разделитель.
• Заключайте значение в двойные кавычки, если оно содержит запятую, двойные кавычки или перенос строки.
• Двойную кавычку внутри значения экранируйте второй двойной кавычкой. Например: ""Хороший"" товар.
• Не меняйте названия колонок и их порядок.
• Передавайте одну строку на один отзыв и не дублируйте reviewId.
• Не добавляйте в файл имя, email, телефон и другие персональные данные автора отзыва.

Передача файла

Разместите полную выгрузку так, чтобы файл был доступен Gravity Field для скачивания по ссылке. Передайте специалисту Gravity Field ссылку на один из двух вариантов:

• reviews.csv — CSV-файл без сжатия;
• reviews.csv.gz — тот же CSV-файл со сжатием gzip.

Выгрузка всегда должна состоять из одного файла. Не разделяйте ее на части. Gzip используется только для сжатия: содержимое reviews.csv.gz должно соответствовать тому же CSV-контракту.

Проверка перед передачей

• Файл сохранен в UTF-8.
• Заголовок содержит все обязательные колонки.
• Каждый reviewId уникален.
• Каждый sku точно совпадает с идентификатором товара в продуктовом фиде.
• rating содержит целое число от 1 до 5.
• status содержит только published, hidden или deleted.
• createdAt и updatedAt соответствуют RFC 3339.
• Запятые, кавычки и переносы строк внутри текстов корректно экранированы.
• В файле нет персональных данных авторов отзывов.
• Полная выгрузка доступна по ссылке одним файлом reviews.csv или reviews.csv.gz.

Передайте ссылку на готовый файл специалисту Gravity Field.