Карусели

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

Иногда контент может появиться в карусели, даже если страница, на которой он размещен, не содержит структурированных данных для списка. Например, мы можем включить ваш рецепт в карусель рецептов с разных сайтов.

Пример

На скриншоте ниже показана карусель, содержащая рецепты куриных блюд с одного сайта.

Карусель с расширенными результатами для рецептов

Требования

Разметка для списка должна соответствовать общим правилам в отношении структурированных данных, а также положениям, приведенным ниже.

  • Все элементы списка должны относиться к одному типу, например Article или Recipe.
  • Демонстрируемый пользователям текст должен соответствовать структурированным данным страницы, на которой он находится.
  • Элементы списка будут показаны в порядке, который определяется свойством position.
  • Пока в списках могут появляться только следующие типы контента: рецепт, курс, статья и ресторан.

Список, формируемый с помощью структурированных данных, можно представить как:

  • обзорную страницу со ссылками на страницы сведений;
  • список категории "всё в одном".

Обзорная страница со ссылками на страницы сведений

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

Обзор Страница сведений
Содержит код списка ItemList. У каждого его элемента, то есть ListItem, есть три свойства: @type (со значением ListItem), position (положение элемента в списке) и url (URL страницы с полными сведениями об элементе списка). Содержит код элемента структурированных данных, соответствующий выбранному типу списка.
Псевдокод для списка "рецепты_самых_вкусных_десертов.html"
ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/coffee_cake.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/apple_pie.html,
    },
    ... more recipes ...
  ]
Псевдокод для списка "кофейное_пирожное.html"
@type: Recipe
name: Party Coffee Cake
author: George Smith
.... more properties ...

Пример кода

Пример кода

Список категории "всё в одном"

Такой список целиком размещен на одной странице вместе с полными описаниями каждого элемента.

Страница со списком категории "всё в одном"
Содержит код списка ItemList. Каждый его элемент относится к типу ListItem и включает в себя свойство item (в соответствии с описанием на сайте schema.org), в котором хранятся структурированные данные о нужном контенте, например о фильмах или курсах. Страница должна содержать видимый пользователями текст и якоря для каждого элемента ListItem.

Псевдокод для списка "рецепты_самых_вкусных_десертов.html"

ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_1
        name: George's Cherry Pie
        author: George Smith
        ... all other required Recipe type properties ...}
    },
    {
      @type: ListItem
      position: 2
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_2
        name: Party Coffee Cake
        author: Mary Stone
        ... all other required Recipe type properties ...}
    },
    ... more recipes ...
  ]
Пример кода

Типы структурированных данных

Для создания своего списка вам необходимо использовать контейнер ItemList как минимум с двумя элементами ListItems. Чтобы контент мог появиться в расширенных результатах, необходимо задать все обязательные свойства. Вы также можете добавить рекомендуемые свойства, чтобы пользователям было удобнее просматривать информацию.

ItemList

ItemList – контейнер, в котором содержатся все элементы списка. Если он размещен на обзорной странице, все URL в списке должны ссылаться на разные страницы в одном домене. Если список относится к категории "всё в одном", все его URL должны ссылаться на страницу со структурированными данными списка.

Полное описание типа ItemList приведено на странице schema.org/ItemList.

Обязательные свойства
itemListElement

ListItem

Список объектов (все они должны относиться к одному типу). Подробная информация представлена в разделе ListItem.

ListItem

ListItem содержит сведения об отдельном элементе списка.

  • На обзорных страницах для элемента ListItem должны быть указаны только свойства type, position и url.
  • В случае со списками категории "всё в одном" элемент ListItem должен содержать все дополнительные свойства по стандарту schema.org для описываемого типа контента, например рецепта (Recipe) или курса (Course).

Полное описание типа ListItem приведено на странице schema.org/ListItem.

Пример элемента в списке на обзорной странице (JSON-LD):

{
  "@type":"ListItem",
  "position":1,
  "url":"http://example.com/desserts/apple-pie"
}

Пример элемента в списке категории "всё в одном" (JSON-LD):

{
  "@type": "ListItem",
  "position": 1,
  "item": {
    "@type": "Recipe",
    "url": "http://example.com/desserts/pies/#apple-pie",
    "name": "Apple Pie",
    "image": "https://example.com/300px-Apple_pie.jpg",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "6",
      "reviewCount": "32"
    },
    "recipeYield": "8 servings",
    "recipeIngredient": [
      "Pastry crust for bottom and top",
      "1/2 cup unsalted butter",
      "3 tablespoons all-purpose flour",
      "1/4 cup water",
      "1/4 cup white sugar",
      "1/2 cup brown sugar",
      "10 cups peeled, chopped green apples"
    ], ... snip ...
  }
}
Обязательные свойства
item

Thing

Требуется только для списков категории "всё в одном" и является для них обязательным. Не используйте это свойство для обзорных страниц. Укажите приведенные ниже значения и все остальные свойства описываемого типа данных.

  • item.name
  • item.url
  • Все прочие свойства, необходимые для конкретного типа данных. Они описаны на сайте schema.org и в документации к вашему типу контента, например к статье или книге. В частности, для книги в списке необходимо указать свойства bookFormat и isbn, а для рецепта – свойства prepTime и image.
item.name

Text

Название элемента, которое будет показано в карусели. HTML-форматирование не учитывается. Это свойство является обязательным для списков категории "всё в одном". Не используйте его для обзорных страниц.

item.url

URL

Полный URL и якорь для описываемого элемента на странице. Это свойство является обязательным для списков категории "всё в одном". Не используйте его для обзорных страниц. Убедитесь, что URL ссылается на текущую страницу, и укажите на странице HTML-якорь (тег <a> либо значение name или id) рядом с текстом, который видят пользователи. Пример: https://example.org/recipes/pies#apple_pie.

position

Integer

Положение элемента в карусели. Минимальное значение равно 1.

url

URL

Требуется только для обзорных страниц и является для них обязательным. Не используйте это свойство для списков категории "всё в одном". Оно содержит канонический URL страницы со сведениями об элементе. Все URL списка должны быть уникальными и входить в тот же домен (верхнего или нижнего уровня), что и обзорная страница.

Оставить отзыв о...

Текущей странице