Карусели

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

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

Пример

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

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

Правила

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

  • Все элементы списка должны относиться к одному типу (например, "Статья" или "Рецепт").
  • Текст, видимый пользователями, должен соответствовать структурированным данным страницы, на которой он находится.
  • Элементы списка будут показаны в порядке, который определяется свойством position.
  • Пока в списках могут появляться только следующие типы контента: рецепт, фильм, курс и статья. Однако вы сможете создать карусель с материалами другого типа, как только мы добавим его поддержку.

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

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

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

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

Обзорная страница Страница сведений
Содержит код списка ItemList. У каждого его элемента, то есть ListItem, есть три свойства: @type (со значением ListItem), position (положение элемента в списке) и url (URL страницы с полными сведениями об элементе списка). Содержит код элемента структурированных данных, соответствующий выбранному типу списка.
Псевдокод для списка "рецепты_самых_вкусных_пирогов.html"
ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/cherry_pie_recipe.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/appple_pie_recipe.html,
    },
    ... more recipes ...
  ]
Псевдокод для элемента "рецепт_вишневого_пирога.html"
@type: Recipe
name: George's Cherry Pie
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: Martha's Apple Pie
        author: Martha Smith
        ... all other required Recipe type properties ...}
    },
    ... more recipes ...
  ]

 

Пример кода

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

Для создания своего списка вам необходимо использовать контейнер ItemList как минимум с двумя элементами ListItems.

ItemList

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

С полным описанием контейнера ItemList можно ознакомиться на сайте schema.org.

Свойства
@type

Обязательное.

Значение – ItemList.

itemListElement

ListItem, обязательное.

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

ListItem

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

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

С полным описанием параметра ListItem можно ознакомиться на сайте schema.org.

Пример элемента в списке на обзорной странице (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"
    ],
  }
}
Свойства
@type

Обязательное.

Значение – ListItem.

position

Integer, обязательное.

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

url

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

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

item

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

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

  • @type – название типа описываемого объекта согласно schema.org. Пример: "Recipe".
  • url – полный URL и якорь для описываемого элемента на странице. Убедитесь, что URL ссылается на текущую страницу и укажите на странице HTML-якорь (тег <a> либо значение name или id) рядом с текстом, видимым пользователями. Пример: "https://example.org/recipes/pies#apple_pie".
  • name – название элемента, которое будет показано в карусели. HTML-форматирование не учитывается.
  • Все прочие свойства, необходимые в зависимости от типа данных. Они описаны на сайте schema.org и в документации к вашему типу контента (например, к статье или книге). Скажем, для книги в списке необходимо указать свойства bookFormat и isbn, а для рецепта – свойства prepTime и image.

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

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