Книга: /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 | Метод, используемый для сбора обзора. Значение должно быть одним из следующих:
|
<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 | Тип должен быть одним из следующих:
Пример: <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), связанные с продуктом.
Элемент | Вхождение | Тип | Описание |
---|---|---|---|
<asin> | Обязательно (1-неограниченно) | nonEmptyStringType | Стандартный идентификационный номер продукта Amazon. Каждый ASIN состоит из 10 буквенно-цифровых символов. |