Receta

Marca el contenido de las recetas con datos estructurados a fin de proporcionar resultados enriquecidos y listas específicas de hosts para tus recetas, como opiniones de usuarios, información nutricional y tiempos de preparación y cocción. Tu página será apta para diferentes funciones, según cómo agregues los datos estructurados:

• Búsqueda: Agrega datos estructurados a tus recetas para fomentar una mejor participación en la Búsqueda con resultados enriquecidos.
• Orientación: Permite que el Asistente de Google ayude a los usuarios con tus recetas en Google Home y pantallas inteligentes.
• Carrusel: Agrega datos estructurados de carrusel para permitir que tus recetas aparezcan en el carrusel de resultados enriquecidos. Estos resultados pueden incluir imágenes, logotipos de páginas y otras funciones interesantes relacionadas.
• AMP: Crea tus propias páginas con AMP para brindar recetas que carguen al instante.

Si estructuras el contenido según esta guía, es posible que se habiliten automáticamente las siguientes funciones:

• La insignia de recetas en los resultados de la Búsqueda de imágenes en dispositivos móviles
• La acción de contenido en el Asistente de Google

Nota: Por el momento, la compatibilidad del contenido de recetas con pantallas inteligentes solo está disponible para socios seleccionados. Si quieres que el contenido de tus recetas aparezca en estas pantallas, llena el formulario de interés.

Prueba nuestro nuevo codelab de datos estructurados. Este laboratorio te mostrará cómo agregar datos estructurados de recetas y opiniones a un sitio HTML simple, dónde ubicar los datos estructurados en un sitio y cómo validarlos.

Ejemplos

Aquí tienes un ejemplo de recetas usando código JSON-LD en la Herramienta de prueba de datos estructurados.

Nota: Es posible que la publicación se vea de otra forma en los resultados de la Búsqueda. Consulta el diseño más reciente de la vista previa de los datos estructurados en la Herramienta de prueba de datos estructurados.

Ejemplo de receta

Aquí hay un ejemplo de una página con datos estructurados de recipe y guías. Este contenido puede ser apto para mostrarse como resultado enriquecido en los resultados de la Búsqueda y como orientación con el Asistente de Google en Google Home y pantallas inteligentes.

{ "@context": "https://schema.org/", "@type": "Recipe", "name": "Party Coffee Cake", "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "author": { "@type": "Person", "name": "Mary Stone" }, "datePublished": "2018-03-10", "description": "This coffee cake is awesome and perfect for parties.", "prepTime": "PT20M", "cookTime": "PT30M", "totalTime": "PT50M", "keywords": "cake for a party, coffee", "recipeYield": "10 servings", "recipeCategory": "Dessert", "recipeCuisine": "American", "nutrition": { "@type": "NutritionInformation", "calories": "270 calories" }, "recipeIngredient": [ "2 cups of flour", "3/4 cup white sugar", "2 teaspoons baking powder", "1/2 teaspoon salt", "1/2 cup butter", "2 eggs", "3/4 cup milk" ], "recipeInstructions": [ { "@type": "HowToStep", "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan." }, { "@type": "HowToStep", "text": "In a large bowl, combine flour, sugar, baking powder, and salt." }, { "@type": "HowToStep", "text": "Mix in the butter, eggs, and milk." }, { "@type": "HowToStep", "text": "Spread into the prepared pan." }, { "@type": "HowToStep", "text": "Bake for 30 to 35 minutes, or until firm." }, { "@type": "HowToStep", "text": "Allow to cool." } ], "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "ratingCount": "18" }, "video": [ { "@type": "VideoObject", "name": "How to make a Party Coffee Cake", "description": "This is how you make a Party Coffee Cake.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "contentUrl": "http://www.example.com/video123.mp4", "embedUrl": "http://www.example.com/videoplayer?video=123", "uploadDate": "2018-02-05T08:00:00+08:00", "duration": "PT1M33S", "interactionCount": "2347", "expires": "2019-02-05T08:00:00+08:00" } ] }

Ejemplo de carrusel

Aquí tienes un ejemplo de una página de resumen de recetas (que incluye una lista) con datos estructurados de itemList. Este contenido puede ser apto para mostrarse en un carrusel de los resultados de la Búsqueda.

{ "@context": "https://schema.org", "@type": "ItemList", "itemListElement": [ { "@type": "ListItem", "position": 1, "url": "https://example.com/apple-pie.html" }, { "@type": "ListItem", "position": 2, "url": "https://example.com/blueberry-pie.html" }, { "@type": "ListItem", "position": 3, "url": "https://example.com/cherry-pie.html" } ] }

Lineamientos

Debes seguir los lineamientos generales de datos estructurados para que tus recetas puedan aparecer en los resultados de la Búsqueda. Si quieres habilitar tu receta para orientación con el Asistente de Google en Google Home y pantallas inteligentes, asegúrate de que el contenido cumpla con las Políticas de restricción de contenido para Actions on Google.

Si infringes estas políticas, es posible que no se muestren tus recetas como resultados enriquecidos, aunque sí aparecerá el contenido en los resultados de la Búsqueda. Obtén más información sobre el lenguaje de marcado estructurado con spam.

Los siguientes lineamientos se aplican a datos estructurados de recetas.

• Usa datos estructurados de recetas para el contenido relacionado con la preparación de un plato en particular. Por ejemplo, "exfoliación facial" o "ideas para fiestas" no son nombres válidos para un plato.
• Para que tus recetas aparezcan en una lista específica de hosts, debes seguir los lineamientos que se indican a continuación:
  • Proporciona datos estructurados del tipo ItemList para resumir las recetas de tu lista. Puedes proporcionar los datos de ItemList por separado o junto con datos estructurados de recetas.
  • Tu sitio debe tener una página de resumen en la que se enumeren todas las recetas de la colección. Por ejemplo, cuando un usuario haga clic en el vínculo del resumen que aparezca en los resultados de la Búsqueda, se lo deberá redireccionar a una página en tu sitio en donde se muestren todas las recetas relacionadas con su búsqueda.

Definiciones de tipos de datos estructurados

Debes incluir las propiedades obligatorias para que tu contenido pueda aparecer como resultado enriquecido o como otro tipo de experiencia en Google. También puedes incluir las propiedades recomendadas para agregar más información sobre tu contenido, lo que podría brindar una mejor experiencia del usuario.

ItemList

La definición completa de ItemList está disponible en schema.org/ItemList.

Además de las Propiedades de recetas, agrega los siguientes elementos a las listas específicas de hosts. Si bien no es obligatorio incluir ItemList, debes agregar las siguientes propiedades si quieres que la receta aparezca en el carrusel de un host. Para obtener más información sobre las listas específicas de hosts, consulta el artículo Carrusel.

Propiedades obligatorias
itemListElement	ListItem Corresponde a la anotación para una página de un solo elemento.
ListItem.position	Integer Corresponde a la posición ordinal de la página del elemento en la lista. Por ejemplo: "itemListElement": [ { "@type": "ListItem", "position": 1, }, { "@type": "ListItem", "position": 2, } ]
ListItem.url	URL Corresponde a la URL canónica de la página del elemento. Cada elemento debe tener una URL única.

Receta

La definición completa de Recipe está disponible en schema.org/Recipe. Marca el contenido de las recetas con las siguientes propiedades del tipo Recipe de Schema.org. Además de los campos obligatorios, marca la mayor cantidad de campos recomendados que puedas para fomentar una mejor participación en la Búsqueda.

Para que el Asistente de Google en Google Home y pantallas inteligentes pueda ayudar a los usuarios con tus recetas, asegúrate de agregar recipeIngredient y recipeInstructions. Si tu contenido no incluye estas propiedades, no será compatible con la orientación, aunque sí se mostrará en los resultados de la Búsqueda.

Propiedades obligatorias
image	URL o ImageObject Corresponde a la imagen del plato terminado. Lineamientos de imagen adicionales: Cada página debe contener al menos una imagen (independientemente de si incluyen lenguaje de marcado o no). Google elegirá la mejor para mostrar en los resultados de la Búsqueda según la relación de aspecto y resolución. Las URL de las imágenes se deben poder rastrear e indexar. Deben representar el contenido con lenguaje de marcado. Deben estar en formato .jpg, .png o .gif. Para obtener mejores resultados, proporciona varias imágenes en alta resolución (mínimo de 50,000 píxeles al multiplicar el ancho por el alto) con la siguiente relación de aspecto: 16 × 9, 4 × 3 y 1 × 1. Por ejemplo: "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ]
name	Text Corresponde al nombre del plato.

Propiedades recomendadas
aggregateRating	AggregateRating Corresponde a la anotación del promedio de calificaciones asignadas al elemento. Sigue los lineamientos para los fragmentos de opiniones, así como la lista de propiedades de AggregateRating obligatorias y recomendadas. Si los datos estructurados de recetas contienen una sola opinión, el nombre del usuario que la deja debe ser de una organización o persona válida. Por ejemplo, "50% de descuento en ingredientes" no es un nombre válido para un usuario que deja una opinión.
author	Person Corresponde al creador de la receta.
cookTime	Duration Corresponde al tiempo que se necesita para cocinar el plato, en formato de la norma ISO 8601. Puedes usar una duración máxima y mínima como elementos secundarios para especificar un rango de tiempo. Usa siempre esta propiedad combinada con prepTime.
datePublished	Date Corresponde a la fecha en la que se publicó la receta, en formato de la norma ISO 8601.
description	Text Corresponde a una breve descripción del plato.
keywords	Text Corresponde a otras propiedades de la receta, como la estación ("verano") y el día festivo ("Halloween"), o bien otras palabras que la describen ("rápida", "fácil", "original"). Lineamientos adicionales Separa varias entradas en una lista de palabras claves con comas. No uses una etiqueta que deba estar en recipeCategory o recipeCuisine. No se recomienda "keywords": "dessert, American" Recomendado "keywords": "winter apple pie, nutmeg crust"
nutrition.calories	Energy Corresponde a la cantidad de calorías por porción.
prepTime	Duration Corresponde a la duración del tiempo de preparación del plato, en formato de la norma ISO 8601. Puedes usar una duración máxima y mínima como elementos secundarios para especificar un rango de tiempo. Usa siempre esta propiedad combinada con cookTime.
recipeCategory	Text Corresponde al tipo de comida o plato de la receta. Por ejemplo: "cena", "entrada" o "postre, bocadillo".
recipeCuisine	Text Corresponde a la región asociada con la receta. Por ejemplo, "francesa" "mediterránea" o "americana".
recipeIngredient	Text Corresponde a un ingrediente que se usa en la receta. Esta es una propiedad recomendada para recetas en la Búsqueda de Google, pero es obligatoria para la orientación con el Asistente de Google en Google Home y pantallas inteligentes. Por ejemplo: "recipeIngredient": [ "1 (15 ounce) package double crust ready-to-use pie crust", "6 cups thinly sliced, peeled apples (6 medium)", "3/4 cup sugar", "2 tablespoons all-purpose flour", "3/4 teaspoon ground cinnamon", "1/4 teaspoon salt", "1/8 teaspoon ground nutmeg", "1 tablespoon lemon juice" ] Lineamientos adicionales: Incluye solo el texto de los ingredientes que sean necesarios para preparar la receta. No incluyas información innecesaria, como la definición de un ingrediente.
recipeInstructions	Text Corresponde a los pasos para preparar el plato. Esta es una propiedad recomendada para recetas en la Búsqueda de Google, pero es obligatoria para la orientación con el Asistente de Google en Google Home y pantallas inteligentes. Existen varias opciones para configurar el valor de recipeInstructions. Se recomienda usar HowToStep o HowToSection: HowToStep: Puedes especificar el texto exacto para cada oración que describa un paso estableciendo el valor de cada HowToStep. Esta acción brinda sugerencias al Asistente de Google, pero ten en cuenta que tal vez agrupe los pasos de la receta de manera diferente en función del contexto. Ejemplo de HowToStep "recipeInstructions": [ { "@type": "HowToStep", "text": "Heat oven to 425°F." }, { "@type": "HowToStep", "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom." }, { "@type": "HowToStep", "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate." }, { "@type": "HowToStep", "text": "Top with second crust." }, { "@type": "HowToStep", "text": "Cut slits or shapes in several places in top crust." }, { "@type": "HowToStep", "text": "Bake 40 to 45 minutes or until apples are tender and crust is golden brown." }, { "@type": "HowToStep", "text": "Cool on cooling rack at least 2 hours before serving." } ] HowToSection (solo si una receta tiene varias secciones): Úsala para agrupar los pasos en varias secciones. Proporciona el nombre de la sección en el campo de nombre (por ejemplo, "Cómo preparar la masa") y especifica cada HowToStep como itemListElement. Establece el campo de texto para cada HowToStep. Por ejemplo, una receta de pizza tal vez tenga una sección de pasos para preparar la masa, una para los ingredientes y otra para la combinación y la cocción. Si no indicas que hay varias secciones, es posible que el Asistente de Google muestre el nombre de la sección como otro paso por error (por ejemplo, "Cómo preparar la masa" seguido de "Cómo combinar la harina con la levadura"). Ejemplo de HowToSection "recipeInstructions": [ { "@type": "HowToSection", "name": "Prepare the Crust", "itemListElement": [ { "@type": "HowToStep", "text": "Heat oven to 425°F." }, { "@type": "HowToStep", "text": "Place 1 pie crust in ungreased 9-inch glass pie plate." } ] }, { "@type": "HowToSection", "name": "Add the Filling", "itemListElement": [ { "@type": "HowToStep", "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate." }, { "@type": "HowToStep", "text": "Top with second crust." }, { "@type": "HowToStep", "text": "Cut slits or shapes in several places in top crust." } ] }, { "@type": "HowToSection", "name": "Bake", "itemListElement": [ { "@type": "HowToStep", "text": "Bake 40 to 45 minutes or until apples are tender and crust is golden brown." }, { "@type": "HowToStep", "text": "Cool on cooling rack at least 2 hours before serving." } ] } ] Campo de texto único o repetido: Es un bloque de texto que incluye uno o varios pasos. Google considera que todos los pasos son parte de una misma sección. Los valores de campos repetidos se concatenan en un solo bloque de texto. Google intenta dividir automáticamente el bloque de texto único en pasos individuales. Luego, trata de buscar y quitar nombres de secciones, números de pasos, palabras clave y cualquier otro elemento que pueda aparecer de manera incorrecta en el texto de los pasos de la receta. Para obtener mejores resultados, especifica de manera clara las oraciones correspondientes a los pasos individuales con HowToStep, tal como se describió anteriormente. Ejemplo de campo de texto único "recipeInstructions": [ "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate. Top with second crust. Cut slits or shapes in several places in top crust. Bake 40 to 45 minutes or until apples are tender and crust is golden brown. Cool on cooling rack at least 2 hours before serving." ] Lineamientos adicionales No incluyas metadatos que correspondan a otro elemento. En particular, usa el campo author para especificar el autor, recipeCuisine para el tipo de cocina, recipeCategory para la categoría y keywords para otras palabras clave. Incluye solamente texto que corresponda a cómo se prepara la receta y no otro como "Cómo llegar", "Mira el video" o "Paso 1". Esas frases se deben especificar fuera de los datos estructurados. No se recomienda "recipeInstructions": [{ "@type": "HowToStep", "text": "Step 1. Heat oven to 425°F." }] Recomendado "recipeInstructions": [{ "@type": "HowToStep", "text": "Heat oven to 425°F." }]
recipeYield	Text Corresponde a las cantidades que rinde la receta. Por ejemplo: el número de porciones o la cantidad de personas.
totalTime	Duration Corresponde al tiempo que lleva preparar y cocinar el plato, en formato de la norma ISO 8601. Puedes usar una duración máxima y mínima como elementos secundarios para especificar un rango de tiempo. Usa totalTime o bien combina cookTime y prepTime.
video	VideoObject Corresponde a una matriz de propiedades de video que representan a la receta en la página. Sigue la lista de propiedades de Video obligatorias y recomendadas. Por ejemplo: { "@context": "https://schema.org/", "@type": "Recipe", "video": [ { "name": "Party Coffee Cake", "description": "How to make Party Coffee Cake.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "contentUrl": "http://www.example.com/videos/123_600x400.mp4", "embedUrl": "http://www.example.com/videoplayer?id=123", "uploadDate": "2018-02-05T08:00:00+08:00" } ] }