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

Книга: /product-review-feeds/_book.yaml

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

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

Вы можете узнать больше о XML-схемах из учебника XML Schema Primer .

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

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

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

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

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

Элемент Вхождение Тип Описание
<version> Требуется (1) xs:string Указывает, какая версия схемы фида отзывов о продуктах используется. В настоящее время поддерживается только <version>2.3</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 Автор обзора продукта.
<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 Содержание обзора.
<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 (глобальные номера предметов торговли), связанные с продуктом.
<mpns> Требуется (MPN должен быть включен для облегчения сопоставления отзывов, если продукт, связанный с обзором, не имеет назначенного GTIN. Должен быть представлен с брендом)

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

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

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

<gtins>

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

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

<mpns>

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

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

<skus>

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

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

<brands>

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

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

<asins>

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

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