Carrusel

Puedes usar datos estructurados para hacer que tus resultados enriquecidos puedan verse en una lista llamada carrusel. Los carruseles generalmente aparecen solo en dispositivos móviles y para ciertos tipos de contenido, tal como se describe a continuación. Si utilizas el marcado de carrusel para un tipo de contenido que en la actualidad no sea compatible con ese formato, no verás ningún error y la información se mostrará, pero no en un carrusel.

En algunos casos, la Búsqueda de Google puede mostrar tu resultado enriquecido dentro de un carrusel, incluso si la página no incluye datos estructurados para una lista. Por ejemplo, una receta puede aparecer en un carrusel de recetas de muchos sitios web diferentes.

Ejemplo

A continuación se muestra un carrusel con la lista de recetas de pollo de un sitio web:

Carrusel de resultados enriquecidos de recetas

Directrices

Además de las directrices estándar de datos estructurados, se aplican las siguientes directrices al marcado de listas:

  • Todos los elementos de la lista deben ser del mismo tipo. Por ejemplo, Article o Recipe.
  • El texto visible para el usuario debe ser similar a la información contenida en los datos estructurados de la página.
  • Los elementos que se muestran en formato de lista se mostrarán en el orden especificado por la propiedad position.
  • Actualmente, el formato de lista es compatible con los tipos de contenido de: receta, curso, artículo, restaurante y película.

Hay dos formas de implementar un formato de lista a tus datos estructurados:

  • Con una página de resumen y varias páginas de detalles completos
  • Con una lista en la que aparece todo

Página de resumen y varias páginas de detalles completos

La página de resumen tiene una breve descripción de cada elemento de la lista, y cada descripción redirige a una página de detalles dedicada por completo a un elemento.

Página de resumen Página de detalles
Define un elemento ItemList, donde cada elemento ListItem solo tiene tres propiedades: @type (que es "ListItem"), position (la posición en la lista) y url (la URL de una página con todos los detalles sobre ese elemento). Define un elemento de datos estructurados adecuado para ese tipo de lista.
Pseudocódigo para best_dessert_recipes.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 ...
  ]
Pseudocódigo para coffee_cake.html:

@type: Recipe
name: Party Coffee Cake
author: George Smith
.... more properties ...

Código de ejemplo:

Código de ejemplo:

Lista en la que aparece todo

Una lista única con todo en una página que aloja toda la información de la lista, incluido el texto completo de cada elemento: por ejemplo, una galería de recetas para varios tipos de magdalenas, todo en una misma página.

Una sola página
Define un elemento ItemList, en el que cada elemento es un elemento ListItem cuya propiedad item se rellena con los datos estructurados para ese tipo de elemento de schema.org (por ejemplo, para películas o para cursos). La página debe contener texto visible para el usuario y un ancla que coincida con cada elemento ListItem.

Pseudocódigo para best_dessert_recipes.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 ...
  ]
Código de ejemplo:

Definiciones de tipos de datos estructurados

Para especificar una lista, debes definir un elemento ItemList que contenga al menos dos elementos ListItems. Debes incluir las propiedades obligatorias para que tu contenido pueda mostrarse como un resultado enriquecido. También puedes incluir las propiedades recomendadas para añadir más información sobre tu contenido, lo que puede ayudar a mejorar la experiencia de usuario.

ItemList

ItemList es el elemento que contiene todos los elementos de la lista. Si se usa en una página de resumen, todas las URL de la lista deben dirigir a diferentes páginas del mismo dominio; si se usa en una lista en la que aparece todo, deben dirigir a la página que aloja los datos estructurados de la lista.

Puedes consultar la definición completa de ItemList en schema.org/ItemList.

Propiedades obligatorias
itemListElement

ListItem

Indica la lista de elementos, que deben ser todos del mismo tipo. Para obtener información detallada, consulta el apartado ListItem.

ListItem

ListItem contiene detalles sobre un elemento concreto en la lista.

  • Si se trata de una página de resumen, ListItem debe incluir solo las propiedades de type, position y url.
  • Si se trata de una lista en la que aparece todo, ListItem debe incluir todas las propiedades adicionales de schema.org del tipo de datos que describe (por ejemplo, objetos de Recipe o Course).

Puedes consultar la definición completa de ListItem en schema.org/ListItem.

Elemento de ejemplo en listas de resumen simple (JSON-LD):

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

Elemento de ejemplo en listas en las que aparece todo (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 ...
  }
}
Propiedades obligatorias
item

Thing

Se usa solo para listas en las que aparece todo. Es obligatorio usar esta propiedad en las listas en las que aparece todo. No se debe incluir en páginas de resumen. Rellena este objeto con los siguientes valores, además de todos los miembros del tipo de datos estructurados específico que se describe:

  • item.name
  • item.url
  • Indica cualquier otra propiedad requerida para este tipo de datos, como se describe en schema.org y las reglas descritas en esos documentos para tu tipo de contenido (por ejemplo, para artículos o libros). Por ejemplo, si se trata de incluir un libro en una lista, añadirías las propiedades bookFormat e isbn mientras que indicarías las propiedades prepTime e image si se tratara de incluir una receta.
item.name

Text

Indica el nombre de cadena de un elemento, que se muestra en la galería renderizada. Se ignora el formato HTML. Es obligatorio usar esta propiedad en las listas en las que aparece todo. No se debe incluir en páginas de resumen.

item.url

URL

Indica la URL completa y el ancla de este elemento de la página. Es obligatorio usar esta propiedad en las listas en las que aparece todo. No se debe incluir en páginas de resumen. La URL debe ser la de la página actual y se debe incluir un ancla HTML (con etiqueta <a> o name o con valor id) en tu página cerca del texto visible para el usuario. Ejemplo: https://example.org/recipes/pies#apple_pie.

position

Integer

Indica la posición del elemento en el carrusel. Se trata de un número que tomará como referencia el 1.

url

URL

Se usa solo en listas de páginas de resumen. Es obligatorio usar esta propiedad en las páginas de resumen. No se debe incluir en listas en las que aparece todo. Indica la URL canónica de la página de detalles de un elemento. Todas las URL que aparecen en la lista deben ser únicas, pero tienen que pertenecer al mismo dominio o al mismo subdominio o superdominio que la página actual.