Отзывы в CSV

Эта страница описывает согласованный формат полной выгрузки отзывов. Подготовьте файл с актуальным состоянием и передайте ссылку команде Gravity Field для согласования первоначальной загрузки.

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

Для доставки новых и изменённых отзывов используйте API доставки отзывов. API принимает те же поля в JSON, включая статусы hidden и deleted, и сохраняет данные. Автоматический импорт CSV и использование отзывов в ответах ассистента ещё не реализованы. Сам файл не включает саммаризацию — краткую выжимку мнений о товаре.

Формат файла

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

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.