XML-схема

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

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

Описание

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

Атрибуты

Имя Формат Происшествия Описание
xmlns xs:строка Требуется (1) Пожалуйста, задайте жесткое кодовое значение следующего значения:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:строка Требуется (1) Пожалуйста, задайте жесткое кодовое значение следующего значения:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:строка Требуется (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‑н) Элемент повторяется для каждого продавца.

<merchant>

Описание

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

Атрибуты

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

Пример 

<merchant id="2739">

Содержит

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

Имя Формат Происшествия Описание
name NonEmptyString Требуется (1) Удобочитаемое отображаемое имя продавца.
merchant_url xs:anyURI Требуется (1) URL-адрес основного сайта продавца.
Не используйте URL-адрес перенаправления для этого значения. Другими словами, значение должно указывать непосредственно на сайт продавца.

Пример:

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

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

Пример:

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

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

<deleted_merchants>

Описание

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

Содержит

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

<deleted_merchant>

Описание

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

Атрибуты

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

Содержит

Имя Формат Происшествия Описание
last_update_timestamp DateTimeWithTimeZone Требуется (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‑н) Элемент повторяется для каждого обзора.

<review>

Описание

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

Атрибуты

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

Пример:

<review id=132739 mid=1234>

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

Содержит

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

Имя Формат Происшествия Описание
reviewer_name NonEmptyString Необязательно (0‑1) Отображаемое имя автора обзора, если у обзора должен быть указан автор. Анонимные обзоры не должны содержать это поле.

Пример:

<reviewer_name>
  Joel
</reviewer_name>

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

Пример:

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

last_update_timestamp DateTimeWithTimeZone Требуется (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 xs:строка Необязательно (0‑1) Заголовок обзора. Заголовок должен быть простым текстом без HTML-тегов.

Пример: 

  <title>
    Great prices
  </title>

content xs:строка Требуется (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) Метод, использованный для сбора отзывов. Значение должно быть одним из следующих:
  • незапрошенный: пользователь не ответил на конкретное сообщение при отправке отзыва.
  • 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‑н) Содержит элементы, относящиеся к одному удаленному отзыву.

<deleted_review>

Описание

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

Атрибуты

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

Содержит

Имя Формат Происшествия Описание
last_update_timestamp DateTimeWithTimeZone Требуется (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>