Справочник по XML-схеме

XML-схема для Google Product Review Feeds определяет приемлемую структуру вашего XML-фида. XML-схемы используют расширение файла .xsd . Как и файлы DTD, XML-схема определяет элементы и атрибуты, которые могут присутствовать в XML-документе.

Дополнительную информацию о схемах XML можно найти в этом руководстве по схемам XML .

XML-схема для каналов обзоров продуктов опубликована здесь: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Ниже приведено описание структуры фида, определяемой этой схемой. В этом описании имена типов с префиксом xs: относятся к встроенным типам XML-схемы, находящимся в пространстве имён XML http://www.w3.org/2001/XMLSchema .

Наша система всегда ожидает полную ленту. Все отзывы, отправленные ранее, но не вошедшие в вашу следующую полную ленту, будут удалены. Поэтому при отправке ленты всегда следует отправлять все отзывы.

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

Элемент <feed> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<version> Требуется (1) xs:string Указывает, какая версия схемы фида отзывов о продукте используется. В настоящее время поддерживается только <version>2.4</version> .
<aggregator> Необязательно (1) aggregatorType Издатель может использовать агрегатор отзывов для управления отзывами и предоставления каналов. Этот элемент указывает на использование агрегатора и содержит информацию об агрегаторе.
<publisher> Требуется (1) publisherType Информация об издателе, которым может быть розничный торговец, производитель, компания, предоставляющая обзоры, или любая организация, публикующая обзоры продуктов.
<reviews> Необязательно (1) xs:sequence Содержит обзоры продукции.

<feed> определяет ограничения уникальности элементов, используемых в ленте.

Дочерние элементы

<aggregator>

Издатель может использовать агрегатор отзывов для управления отзывами и предоставления каналов. Этот элемент указывает на использование агрегатора и содержит информацию об агрегаторе. Элемент <aggregator> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<name> Требуется (1) nonEmptyStringType Название агрегатора отзывов о продуктах.

<publisher>

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

Элемент Возникновение Тип Описание
<name> Требуется (1) nonEmptyStringType Название издателя обзоров продуктов.
<favicon> Необязательно (1) httpUrlType Ссылка на фавикон компании-издателя. Размер изображения должен соответствовать размеру фавикона: 16x16 пикселей. Формат изображения должен быть GIF, JPG или PNG.

<reviews>

Содержит обзоры товаров. Элемент <reviews> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<review> Обязательно (1-неограниченно) reviewType Отдельный уникальный обзор продукта. Если обзор относится к нескольким продуктам из ассортимента издателя, укажите его один раз и включите несколько элементов <product> в элемент <products> .

<review>

Отдельный уникальный обзор продукта. Если обзор относится к нескольким продуктам из ассортимента издателя, укажите его один раз и включите несколько элементов <product> в элемент <products> Элемент <review> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<review_id> Требуется (1) nonEmptyStringType Постоянный, уникальный идентификатор обзора продукта в системе издателя.
<reviewer> Требуется (1) reviewerType Автор обзора продукта.
<is_verified_purchase> Необязательно (1) xs:boolean Указывает, было ли подтверждено, что автор отзыва приобрел данный продукт.
<is_incentivized_review> Необязательно (1) xs:boolean Указывает, был ли рецензент заинтересован в написании обзора продукта.
<review_timestamp> Требуется (1) xs:dateTime

Метка времени, указывающая, когда был написан обзор.

Примеры:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Необязательно (1) nonEmptyStringType Название обзора.
<content> Требуется (1) nonEmptyStringType Содержание обзора.
<review_language> Необязательно (1) xs:string Язык обзора (BCP 47).
<review_country> Необязательно (1) xs:string Код страны (ISO 3166-1) рецензента.
<pros> Необязательно (1) xs:sequence Содержит положительные отзывы, основанные на мнении рецензента. Не используйте шаблонный текст типа «pro:», если только он не был написан рецензентом.
<cons> Необязательно (1) xs:sequence Содержит минусы, основанные на мнении рецензента. Не используйте шаблонный текст типа «con:», если только он не был написан рецензентом.
<reviewer_images> Необязательно (1) xs:sequence Содержит ссылки на изображения продукта, предоставленные рецензентом.
<review_url> Требуется (1) reviewUrlType URL целевой страницы обзора.
<ratings> Требуется (1) xs:sequence Содержит оценки, связанные с обзором.
<products> Требуется (1) xs:sequence Содержит продукты, связанные с обзором.
<is_spam> Необязательно (1) xs:boolean Указывает, отмечен ли отзыв как спам в системе издателя.
<collection_method> Необязательно (1) collectionMethodType

Метод сбора отзывов. Значение должно быть одним из следующих:

unsolicited
Пользователь не отвечал на конкретное предложение при отправке отзыва.
post_fulfillment
Пользователь отправил отзыв в ответ на запрос после выполнения заказа пользователя.
<transaction_id> Необязательно (1) nonEmptyStringType Постоянный уникальный идентификатор транзакции, связанной с отзывом в системе издателя. Этот идентификатор можно использовать для указания того, что с одной и той же транзакцией связано несколько отзывов.

<reviewer>

Автор обзора продукта. Элемент <reviewer> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<name> Требуется (1) reviewerNameType

Имя автора обзора.

Пример:

<name>Jane</name>
<reviewer_id> Необязательно (1) nonEmptyStringType

Постоянный уникальный идентификатор автора обзора в системе издателя.

Пример:

<reviewer_id>14295</reviewer_id>

<name>

Имя автора отзыва. Элемент <name> является расширением типа nonEmptyStringType и содержит имя или псевдоним рецензента. Элемент <name> содержит эти атрибуты.

Атрибут Возникновение Тип Описание
is_anonymous Необязательный xs:boolean

Указывает, является ли рецензент анонимным.

Пример:

<name is_anonymous="true">Anonymous</name>

<pros>

Содержит положительные отзывы, основанные на мнении рецензента. Элемент <pros> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<pro> Обязательно (1-неограниченно) nonEmptyStringType

Отдельный плюс, основанный на мнении рецензента. Плюсы должны быть перечислены в том же порядке, в котором они отображаются. Не используйте шаблонный текст, например «pro:», если только он не был написан рецензентом.

Пример:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

Содержит минусы, основанные на мнении рецензента. Элемент <cons> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<con> Обязательно (1-неограниченно) nonEmptyStringType

Отдельный минус, основанный на мнении рецензента. Минусы следует перечислять в том же порядке, в котором они представлены. Не используйте шаблонный текст типа «con:», если только он не был написан рецензентом.

Пример:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

URL целевой страницы обзора. Элемент <review_url> является расширением httpUrlType и содержит ссылку на целевую страницу обзора. Элемент <review_url> содержит эти атрибуты.

Атрибут Возникновение Тип Описание
type Необходимый xs:string

Тип должен быть одним из следующих:

singleton
Страница обзоров содержит только этот единственный обзор.
group
Страница обзоров содержит группу обзоров, включая этот обзор.

Пример:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Содержит изображения продукта, предоставленные рецензентом. Тег <reviewer_images> содержит множество элементов <reviewer_image> .

Элемент Возникновение Тип Описание
<reviewer_image> Обязательно (1-неограниченно) reviewImageType

Изображение рецензируемого продукта, созданное автором обзора.

<reviewer_image>

Элемент изображения отдельного отзыва.

Элемент Возникновение Тип Описание
<url> Требуется (1) httpUrlType

URL-адрес изображения рассматриваемого продукта, созданный автором обзора. URL-адрес не обязательно должен заканчиваться расширением файла изображения.

Пример:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

Содержит оценки, связанные с отзывом. Элемент <ratings> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<overall> Требуется (1) ratingType Общая оценка продукта рецензентом.

<overall>

Общая оценка продукта рецензентом. Элемент <overall> расширяет тип xs:decimal simpleType и содержит оценку, присвоенную рецензентом. Значение должно находиться в пределах диапазона, определяемого атрибутами min и max . Элемент <overall> содержит эти атрибуты.

Атрибут Возникновение Тип Описание
min Необходимый xs:integer Минимально возможное число для оценки. Это должно быть наихудшее возможное значение и не должно быть значением, соответствующим отсутствию оценки.
max Необходимый xs:integer Максимально возможное число для оценки. Значение атрибута max должно быть больше значения атрибута min .

<products>

Содержит товары, связанные с обзором. Элемент <products> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<product> Обязательно (1-неограниченно) productType Продукт, связанный с обзором.

<product>

Продукт, связанный с обзором. Элемент <product> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<product_ids> Необязательно (1) productIdsType Идентификаторы, связанные с продуктом.
<product_name> Необязательно (1) nonEmptyStringType Описательное название продукта.
<product_url> Требуется (1) httpUrlType URL-адрес товара. Этот URL-адрес может иметь то же значение, что и элемент <review_url> , если URL-адрес обзора и URL-адрес товара совпадают.

<product_ids>

Идентификаторы, связанные с продуктом. Элемент <product_ids> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<gtins> Обязательно (для всех обзоров, связанных с продуктами с известным GTIN)

Необязательно для всех остальных обзоров (1)		 gtinsType Содержит коды GTIN (глобальные номера товаров), связанные с товаром. Поддерживаются подтипы GTIN (например, UPC, EAN, ISBN, JAN).
<mpns> Обязательно (для всех обзоров, связанных с продуктами с известным MPN)

Необязательно для всех остальных обзоров (1)		 mpnsType Содержит MPN (номера деталей производителя), связанные с продуктом.
<skus> Обязательно (для всех обзоров, связанных с продуктами с известным артикулом)

Необязательно для всех остальных обзоров (1)		 skusType Содержит артикулы (единицы складского хранения), связанные с продуктом. Часто они совпадают с идентификатором предложения в фиде продуктов.
<brands> Обязательно (для всех обзоров, связанных с продуктами известного бренда)

Необязательно для всех остальных обзоров (1)		 brandsType Содержит названия брендов, связанных с продуктом.
<asins> Необязательно (1) asinsType Содержит ASIN (стандартные идентификационные номера Amazon), связанные с продуктом.

<gtins>

Содержит коды GTIN (глобальные коды товаров), связанные с товаром. Элемент <gtins> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<gtin> Обязательно (1-неограниченно) nonEmptyStringType Глобальный номер товара. Поддерживаются подтипы GTIN (например, UPC, EAN, ISBN, JAN).

<mpns>

Содержит MPN (номера деталей производителя), связанные с продуктом. Элемент <mpns> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<mpn> Обязательно (1-неограниченно) nonEmptyStringType Номер детали производителя продукта.

<skus>

Содержит артикулы (единицы складского хранения), связанные с товаром. Элемент <skus> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<sku> Обязательно (1-неограниченно) nonEmptyStringType Единица учета продукции в инвентаре издателя.

<brands>

Содержит названия брендов, связанных с продуктом. Элемент <brands> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<brand> Обязательно (1-неограниченно) nonEmptyStringType Название бренда продукта.

<asins>

Содержит ASIN (стандартные идентификационные номера Amazon), связанные с товаром. Элемент <asins> содержит эти элементы в указанном порядке.

Элемент Возникновение Тип Описание
<asin> Обязательно (1-неограниченно) nonEmptyStringType Стандартный идентификационный номер товара Amazon. Каждый ASIN состоит из 10 букв и цифр.