XML-схема

В этом разделе описывается XML-схема, используемая для фида данных отзывов продавцов.

Элемент верхнего уровня: <feed>

Описание

Самый верхний элемент-контейнер, содержащий все остальные элементы фида.

Атрибуты

Имя Формат Вхождения Описание
xmlns хз: строка Требуется (1) Пожалуйста, жестко закодируйте следующее значение:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi хз: строка Требуется (1) Пожалуйста, жестко закодируйте следующее значение:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation хз: строка Требуется (1) Пожалуйста, жестко закодируйте следующее значение, оставив один пробел между URL-адресами:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Пример

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Содержит

Имя Формат Вхождения Описание
merchants -- Дополнительно (0–1) Элемент-контейнер для элементов <merchant> .
deleted_merchants -- Дополнительно (0–1) Элемент-контейнер для элементов <deleted_merchant> .
reviews -- Дополнительно (0–1) Элемент-контейнер для элементов <review> .
deleted_reviews -- Дополнительно (0–1) Элемент-контейнер для элементов <deleted_review> .

<merchants>

Описание

Контейнер для элементов <merchant> .

Содержит

Имя Формат Вхождения Описание
merchant -- Требуется (1‑n) Элемент повторяется для каждого торговца.

<merchant>

Описание

Каждый элемент <merchant> содержит информацию и отзывы для одного продавца.

Атрибуты

Имя Формат Вхождения Описание
id Идентификатор Требуется (1) Должен быть уникальным и стабильным во всех фидах. Другими словами, если фид сегодня и фид 90 дней назад относятся к одному и тому же продавцу, у них должен быть один и тот же идентификатор.

Пример

<merchant id="2739">

Содержит

Включите следующие элементы в элемент продавца.

Имя Формат Вхождения Описание
name непустая строка Требуется (1) Человекочитаемое отображаемое имя продавца.
merchant_url хз:любойURI Требуется (1) URL-адрес основного сайта продавца.
Не используйте URL-адрес перенаправления для этого значения. Другими словами, значение должно указывать прямо на сайт продавца.

Пример: 

<merchant_url>
  http://store.google.com
</merchant_url>

rating_url хз:любойURI Требуется (1) URL-адрес целевой страницы, на которой размещены отзывы об этом продавце.
Не используйте URL-адрес перенаправления.

Пример: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>

create_timestamp ДатаВремяВистимезоне Требуется (1) Время/дата создания продавца. Это никогда не должно меняться.
last_update_timestamp ДатаВремяВистимезоне Требуется (1) Время/дата последнего обновления продавца. Если какое-либо из полей в элементе <merchant> обновляется для данного идентификатора продавца, это значение также должно измениться.

<deleted_merchants>

Описание

Контейнер для торговцев, которые были удалены.

Содержит

Имя Формат Вхождения Описание
deleted_merchant -- Требуется (1‑n) Содержит элементы, относящиеся к одному удаленному продавцу.

<deleted_merchant>

Описание

Продавец, который был удален.

Атрибуты

Имя Формат Вхождения Описание
id Идентификатор Требуется (1) Указывает идентификатор мерчанта, которого следует удалить из ленты. Идентификатор должен совпадать с атрибутом id элемента <merchant> в любом предыдущем файле фида.

Содержит

Имя Формат Вхождения Описание
last_update_timestamp ДатаВремяВистимезоне Требуется (1) Время/дата удаления продавца из системы.

Пример: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

Пример

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

Описание

Контейнер для элементов <review> .

Содержит

Имя Формат Вхождения Описание
review -- Требуется (1‑n) Элемент повторяется для каждого обзора.

<review>

Описание

Контейнер для сведений, связанных с обзором.

Атрибуты

Имя Формат Вхождения Описание
id Идентификатор Требуется (1) Идентификатор отзыва в вашей системе. Должен быть уникальным и стабильным во всех фидах.

Пример: 

<review id=132739 mid=1234>

mid Идентификатор Требуется (1) Идентификатор продавца, которому предназначен этот отзыв.

Содержит

Пожалуйста, включите следующие элементы в элемент обзора.

Имя Формат Вхождения Описание
reviewer_name непустая строка Дополнительно (0–1) Отображаемое имя автора отзыва, при условии, что у обзора должен быть указан автор. Анонимные отзывы не должны включать это поле.

Пример: 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp ДатаВремяВистимезоне Требуется (1) Время/дата отзыва, отправленного пользователем. Это никогда не должно меняться.

Пример: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>

last_update_timestamp ДатаВремяВистимезоне Требуется (1) Время/дата последнего изменения информации в элементе <review> . Если какое-либо из полей в элементе <review> обновляется для данного идентификатора обзора, это значение также должно измениться.

Пример: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

country_code Код страны Требуется (1) Страна рецензента. Если доступно, это страна, в которую был отправлен продукт или где была оказана услуга. В противном случае используйте страну, в которой находится рецензент на момент создания обзора. Код страны должен быть в формате ISO 3166-1 alpha-2 .

Пример: 

  <country_code>
    US
  </country_code>

title хз: строка Дополнительно (0–1) Название обзора. Заголовок должен быть простым текстом без HTML-тегов.

Пример: 

  <title>
    Great prices
  </title>

content хз: строка Требуется (1) Содержание обзора. Это должен быть любой текст произвольной формы, предоставленный пользователем, и он не должен быть усечен. Содержимое должно быть простым текстом без каких-либо тегов HTML. Например, разрыв строки должен быть представлен символом перевода строки, а не тегом <br>. Если предоставлено несколько ответов на разные вопросы, все ответы должны быть включены с минимальным контекстом, чтобы ответы имели смысл. Контекст не должен предоставляться, если вопросы остались без ответа.

Пример: 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

Пример: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- Требуется (1) Элемент-контейнер для оценок продавца рецензентом. Если для элемента <overall> рейтинг недоступен, то весь связанный отзыв должен быть исключен из фида, поскольку элемент <overall> является обязательным, и отзыв не будет принят без него.
collection_method CollectionMethodType Требуется (1) Метод, который использовался для сбора обзора. Значение должно быть одним из следующих:
  • unsolicited: пользователь не отвечал на конкретный запрос, когда отправлял отзыв.
  • point_of_sale: Пользователь отправил отзыв в ответ на запрос при размещении заказа.
  • after_fulfillment: Пользователь отправил отзыв в ответ на запрос после выполнения заказа пользователя.

Пример: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Описание

Содержит оценки рецензента продавца. Если для элемента <overall> рейтинг недоступен, то весь связанный отзыв должен быть исключен из фида, поскольку элемент <overall> является обязательным, и отзыв не будет принят без него.

Содержит

Пожалуйста, включите следующие элементы в элемент рейтинга.

Имя Формат Вхождения Описание
overall Диапазон рейтинга Требуется (1) Общая оценка рецензентом продавца.

Пример: 

  <overall min="1" max="10">9</overall>

customer_service Диапазон рейтинга Дополнительно (0–1) Оценка рецензентом качества обслуживания клиентов для этого продавца.

Пример: 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

Описание

Контейнер для отзывов, которые были удалены.

Содержит

Имя Формат Вхождения Описание
deleted_review -- Требуется (1‑n) Содержит элементы, относящиеся к одному удаленному отзыву.

<deleted_review>

Описание

Отзыв, который был удален.

Атрибуты

Имя Формат Вхождения Описание
id Идентификатор Требуется (1) Указывает идентификатор отзыва, который следует удалить из ленты. Идентификатор должен совпадать с атрибутом id элемента <review> в любом файле фида.

Содержит

Имя Формат Вхождения Описание
last_update_timestamp ДатаВремяВистимезоне Требуется (1) Время, когда отзыв был удален из системы.

Пример: 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

Пример

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>