Семантика фида обзора
Семантика ленты отзывов немного отличается:
Для каналов обзора снимков:
- Если в ленте отзывов есть поставщик услуг, то, если в данный момент поставщик отсутствует в базе данных поставщиков LSA, отзывы о нем не будут учтены.
- Если в ленте отзывов есть поставщик услуг, то отзывы о нем будут обработаны следующим образом:
- Если в ленте нет соответствующего отзыва в хранилище LSA, его следует создать.
- Для любого обзора в ленте, если соответствующий обзор существует в хранилище LSA, обзор будет обновлен новой информацией.
- Для любого отзыва, не представленного в ленте, если соответствующий отзыв существует в хранилище LSA, то отзыв будет удален.
- Отзывы о любом поставщике услуг, не включенном в ленту отзывов, если такой поставщик в настоящее время существует в базе данных поставщиков LSA, будут удалены, а поставщик прекратит предоставление услуг.
- Обратите внимание, что поставщик с 0 отзывами также должен иметь запись (а не быть пропущенным) в лентах отзывов, чтобы иметь возможность обслуживать его (см. пример ленты отзывов — listingId 2).
Обратите внимание, что инкрементный метод не поддерживается для каналов отзывов. Для каждого канала профиля требуется соответствующий канал отзывов.
Обработка ошибок в отзывах
Если элемент фида отзывов недействителен, мы пропустим обработку этого элемента фида и продолжим обработку оставшихся действительных элементов фида.
Если фид отзывов недействителен (например, не соответствует схеме), мы прекратим обработку всего фида отзывов.
Поля обзора
| Имя поля | Тип | Описание | Пример | Необходимый | Ограничения |
|---|---|---|---|---|---|
| serviceProviderId | число | Уникальный идентификатор листинга (поставщика услуг) | 12345 | Да | Должен вписываться в int64 |
| рейтингКоличество | целое число | Количество проверенных потребительских оценок | 10 | Да | Должно быть ноль или больше. |
| автор | нить | Имя автора обзора | «Джек Л.» | Нет | |
| reviewId | нить | Уникальный идентификатор отзыва. Если у каждого отзыва нет уникального идентификатора, необходимо сгенерировать уникальный идентификатор для каждого отзыва (например, хэш текста отзыва и пользователя), как минимум уникальный среди всех отзывов одного поставщика. | «123» | Да | |
| reviewText | нить | Текст обзора, написанный автором | "Хорошая работа!" | Нет | |
| рейтинг | целое число | Рейтинг (должен быть целым числом от 1 до 5) | 4 | Да | Должно быть целым числом от 1 до 5. |
| сервисМестоположениеГород | нить | Город, где была оказана услуга | "Нью-Йорк" | Нет | |
| обзорTimestampMicros | целое число | Временная метка написания обзора в микросекундном формате. | 1.45142E+15 | Нет | |
| serviceTimestampMicros | целое число | Временная метка завершения обслуживания в микросекундном формате. | 1.45132E+15 | Нет | |
| язык | нить | Язык текста отзыва, указанный в коде ISO 639-1 (строчные буквы, 2 буквы). Должен соответствовать целевому языку поставщика. | «en» | Нет | Должен соответствовать целевому языку, указанному для связанного поставщика. Если язык не указан, по умолчанию используется «en». |
| категория | объект | структура категории | Нет | ||
| категория->categoryId | перечисление | категория услуги (в таксономии LSA) | «гаражная_дверь_про» | Нет | |
| категория->задача | перечисление | Тип работы (задачи) услуги (в таксономии LSA) | «Ремонт гаражных ворот» | Нет | |
| подтвержденныйКлиент | булев | Если отзыв исходит от подтвержденного клиента (с лидом) | истинный | Нет |