البيانات المنظَّمة لوصفات الطعام (Recipe، وHowTo، وItemList)

يمكنك مساعدة المستخدمين في العثور على محتوى وصفات الطعام الذي تقدّمه على موقعك عن طريق إخبار محرّك البحث Google عن وصفاتك باستخدام البيانات المنظّمة. عندما تُقدِّم معلومات مثل تقييمات المراجعين والأوقات المُستغرقة في الطهي والتحضير ومعلومات عن التغذية، يصبح بإمكان Google فهم الوصفة بشكل أفضل وتقديمها للمستخدمين بطرق مثيرة للاهتمام. ويمكن أن تظهر وصفات الطعام في نتائج البحث من Google و"صور بحث Google".

صورة توضيحية تبيّن شكل ظهور نتائج منسّقة لوصفات طعام ضمن "بحث Google" وتشمل 4 نتائج منسّقة من مواقع إلكترونية مختلفة، مع تفاصيل عن المدة التي يستغرقها تحضير الوصفة وصورة ومعلومات المراجعات صورة توضيحية تبيّن شكل ظهور وصفات طعام ضمن "صور بحث Google" وتعرض 6 نتائج صور تظهر فيها أطعمة مختلفة، وتتضمن 3 نتائج منها شارة وصفة لإعلام المستخدمين بأنّ المحتوى هو وصفة

بالاستناد إلى طريقة ترميز المحتوى، يمكن أن تكون وصفاتك مؤهَّلة للحصول على التحسينات التالية:

تحسينات الوصفات
وصفات الطعام الإرشادية: يمكنك تفعيل "مساعد Google‏" لإرشاد المستخدمين أثناء التنقّل بين وصفاتك على Google Home والشاشات الذكية عن طريق إضافة بيانات Recipe المنظَّمة. وهناك سمات إضافية مطلوبة لوصفات الطعام الإرشادية، ولكن يُنصَح باستخدامها فقط مع محرّك بحث Google. احرص على إضافة recipeIngredient و recipeInstructions. إذا أضفت السمة video، يجب أيضًا إضافة السمة contentUrl.

لمزيد من المعلومات حول وصفات الطعام على "مساعد Google"، يمكنك الاطّلاع على كيفية إنشاء المهام من المحتوى على الويب.

صورة توضيحية تبيّن شكل ظهور وصفات إرشادية على Google Home من خلال "مساعد Google"، وتعرض كيفية استجابة "مساعد Google" لطلب المستخدم من خلال عرض وصفات محتمَلة يمكن تحضيرها
لوحة عرض دوّارة لمضيف وصفات الطعام: يمكنك أن تتيح للمستخدمين إمكانية الاطّلاع على صفحات معرض الوصفات الخاص بك عن طريق إضافة بيانات ItemList المنظّمة. صورة توضيحية تبيّن شكل ظهور لوحة عرض دوّارة لمضيف وصفات طعام ضمن "بحث Google"، وتعرض 3 وصفات مختلفة من الموقع الإلكتروني نفسه بتنسيق لوحة عرض دوارة يمكن للمستخدمين استكشافها واختيار وصفة محدّدة منها

كيفية إضافة البيانات المنظَّمة

البيانات المنظَّمة هي تنسيق موحّد لتقديم معلومات عن صفحة محدّدة وتصنيف محتواها. إذا كنت لا تزال مبتدئًا في مجال البيانات المنظَّمة، يمكنك الاطّلاع على المزيد من المعلومات حول آلية عمل البيانات المنظَّمة.

إليك نظرة عامة حول كيفية إنشاء بيانات منظَّمة واختبارها وإصدارها. للحصول على دليل مفصّل حول كيفية إضافة بيانات منظَّمة إلى صفحة ويب، يمكنك الاطّلاع على الدرس التطبيقي حول الترميز الخاص بالبيانات المنظَّمة.

  1. أضِف السمات المطلوبة. استنادًا إلى التنسيق الذي تستخدمه، يمكنك معرفة مكان إدراج البيانات المنظَّمة في الصفحة.
  2. اتّبِع الإرشادات.
  3. تحقَّق من صحة الرمز باستخدام اختبار النتائج المنسّقة، وأصلِح أي أخطاء ملحّة. ننصحك أيضًا بحلّ أي مشاكل غير ملحّة قد ترصدها الأداة لأنّ ذلك قد يساعدك على تحسين جودة بياناتك المنظَّمة (ولكن هذا الإجراء ليس ضروريًا لتكون بياناتك مؤهّلة للظهور ضمن النتائج المنسّقة).
  4. انشر بعض الصفحات التي تتضمّن بياناتك المنظَّمة واستخدِم أداة فحص عنوان URL لاختبار الطريقة التي يرى بها محرّك بحث Google الصفحة. تأكَّد من أنّ Google يستطيع الوصول إلى صفحتك ومن أنّه لم يتم حظرها باستخدام ملف robots.txt أو علامة noindex أو متطلبات تسجيل الدخول. إذا بدت الصفحة جيدة، يمكنك أن تطلب من محرّك بحث Google إعادة الزحف إلى عناوين URL الخاصة بك.
  5. لإعلام Google بأي تغييرات لاحقة، ننصحك بإرسال خريطة موقع. يمكنك برمجة هذا الإجراء باستخدام Search Console Sitemap API.

أمثلة

إليك بعض الأمثلة لوصفات باستخدام رمز JSON-LD.

وصفات الطعام الإرشادية

في ما يلي مثال لصفحة مؤهّلة للعرض على "بحث Google‏" وكوصفة طعام إرشادية ضمن خدمة "مساعد Google‏".

<html>
  <head>
    <title>Party Coffee Cake</title>
    <script type="application/ld+json">
    {
      "@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",
      "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",
          "name": "Preheat",
          "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.",
          "url": "https://example.com/party-coffee-cake#step1",
          "image": "https://example.com/photos/party-coffee-cake/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Mix dry ingredients",
          "text": "In a large bowl, combine flour, sugar, baking powder, and salt.",
          "url": "https://example.com/party-coffee-cake#step2",
          "image": "https://example.com/photos/party-coffee-cake/step2.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Add wet ingredients",
          "text": "Mix in the butter, eggs, and milk.",
          "url": "https://example.com/party-coffee-cake#step3",
          "image": "https://example.com/photos/party-coffee-cake/step3.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Spread into pan",
          "text": "Spread into the prepared pan.",
          "url": "https://example.com/party-coffee-cake#step4",
          "image": "https://example.com/photos/party-coffee-cake/step4.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Bake",
          "text": "Bake for 30 to 35 minutes, or until firm.",
          "url": "https://example.com/party-coffee-cake#step5",
          "image": "https://example.com/photos/party-coffee-cake/step5.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Enjoy",
          "text": "Allow to cool and enjoy.",
          "url": "https://example.com/party-coffee-cake#step6",
          "image": "https://example.com/photos/party-coffee-cake/step6.jpg"
        }
      ],
      "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": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

وصفة طعام على &quot;بحث Google‏&quot;

في ما يلي مثال على صفحة مؤهّلة للعرض على &quot;بحث Google‏&quot;.

<html>
  <head>
    <title>Non-alcoholic Pina Colada</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Non-alcoholic Pina Colada",
      "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 non-alcoholic pina colada is everyone's favorite!",
      "recipeCuisine": "American",
      "prepTime": "PT1M",
      "cookTime": "PT2M",
      "totalTime": "PT3M",
      "keywords": "non-alcoholic",
      "recipeYield": "1 serving",
      "recipeCategory": "Drink",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "recipeIngredient": [
        "2 cups of pineapple juice",
        "5/8 cup cream of coconut",
        "ice"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "text": "Blend 2 cups of pineapple juice and 5/8 cup cream of coconut until smooth."
        },
        {
          "@type": "HowToStep",
          "text": "Fill a glass with ice."
        },
        {
          "@type": "HowToStep",
          "text": "Pour the pineapple juice and coconut mixture over ice."
        }
      ],
      "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": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

في ما يلي مثال لصفحة ملخّص الوصفات (صفحة بها قائمة وصفات) باستخدام بيانات itemList المنظَّمة. يمكن أن يكون هذا المحتوى مؤهّلاً للعرض على شكل مربّعات في نتائج &quot;بحث Google‏&quot;.

<html>
  <head>
    <title>Grandma's Best Pie Recipes</title>
    <script type="application/ld+json">
    {
      "@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"
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

الإرشادات

يجب اتّباع الإرشادات العامة حول البيانات المنظَّمة لكي تكون وصفتك مؤهّلة للظهور ضمن نتائج البحث على Google. وإذا كنت تريد عرض الوصفة كوصفة طعام إرشادية في خدمة &quot;مساعد Google‏&quot;، تأكَّد من أنّ المحتوى يتّبع سياسة قيود المحتوى المطبّقة في خدمة &quot;مساعد Google‏&quot;.

تسري الإرشادات التالية على بيانات Recipe المنظَّمة.

  • استخدِم بيانات Recipe المنظَّمة للمحتوى المتعلق بإعداد صنف طعام معيّن. على سبيل المثال، لا تمثّل عبارة "كريم تقشير الوجه" أو "أفكار لتنظيم الحفلات" أسماءً صالحة لصنف طعام.
  • لإظهار الوصفات الخاصة بك في ‫لوحة عرض دوّارة أو شبكة، يجب اتّباع الإرشادات التالية:
    • يمكنك توفير بيانات ItemList المنظَّمة لتلخيص الوصفات لعمل القائمة. ويمكنك توفير بيانات ItemList المنظَّمة بشكل منفصل أو مع البيانات المُنظَّمة للوصفات.
    • يجب أن يحتوي موقعك الإلكتروني على صفحة ملخّص تسرد مجموعة الوصفات كلها. مثلًا، عندما ينقر المستخدم على رابط الملخّص من نتائج البحث على Google، يتم توجيهه بطريقة مناسبة إلى صفحة على الموقع الإلكتروني تضم قائمة بالوصفات المرتبطة بعملية البحث التي أجراها.

تعريفات أنواع البيانات المنظّمة

يجب تضمين السمات المطلوبة حتى يصبح المحتوى مؤهَّلاً للعرض كنتيجة منسّقة ضمن نتائج البحث من Google. ويمكنك أيضًا تضمين الخصائص المقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى الذي تعرضه، ما يؤدي إلى تحسين تجربة المستخدم.

Recipe

استخدِم السمات التالية لنوع Recipe من schema.org في ترميز محتوى وصفات الطعام. يتوفّر التعريف الكامل للسمة Recipe على schema.org/Recipe. في ما يلي السمات المتوافقة مع Google:

السمات المطلوبة
image

URL أو ImageObject

تمثّل هذه السمة صورة صنف الطعام بعد اكتماله.

Additional image guidelines:

  • Every page must contain at least one image (whether or not you include markup). Google will pick the best image to display in Search results based on the aspect ratio and resolution.
  • Image URLs must be crawlable and indexable. To check if Google can access your URLs, use the URL Inspection tool.
  • Images must represent the marked up content.
  • Images must be in a file format that's supported by Google Images.
  • For best results, we recommend providing multiple high-resolution images (minimum of 50K pixels when multiplying width and height) with the following aspect ratios: 16x9, 4x3, and 1x1.

For example:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
name

Text

تمثّل هذه السمة اسم الطبق.
السمات المقترَحة
aggregateRating

AggregateRating

تمثّل هذه السمة تعليقًا توضيحيًّا لمتوسط نتيجة المراجعات الممنوحة للطبق. ويمكنك اتّباع إرشادات مقتطف المراجعة وقائمة سمات AggregateRating المطلوبة والمقترَحة.

إذا تضمّنت بيانات Recipe المنظَّمة مراجعة واحدة، يجب أن يكون اسم المراجع اسمًا صالحًا لشخص أو مؤسسة. على سبيل المثال، "50% خصم على المكونات" ليس اسمًا صالحًا لمراجع.
author

Person أو Organization

اسم الشخص أو المؤسسة التي كتبت الوصفة. لمساعدة محرّك بحث Google في التعرّف بشكل أفضل على المؤلفين عبر الميزات المتنوعة، ننصحك باتّباع أفضل الممارسات المتعلقة بترميز معلومات المؤلفين.
cookTime

Duration

تمثّل هذه السمة الوقت الذي يستغرقه طهي الطبق بالتنسيق ISO 8601.

وعليك استخدامها دائمًا مع prepTime.

datePublished

Date

تمثّل هذه السمة تاريخ نشر الوصفة بالتنسيق ISO 8601.
description

Text

تمثّل هذه السمة ملخّصًا لوصف طبق الطعام.
keywords

Text

عبارات أخرى عن وصفتك، مثل الموسم ("الصيف") أو العطلة ("شم النسيم") أو أوصاف أخرى ("سريعة" أو "سهلة" أو "أصلية")

إرشادات إضافية

  • استخدِم فواصل بين الإدخالات المتعددة في قائمة الكلمات الرئيسية.
  • لا تستخدِم علامة تمثّل السمة recipeCategory أو السمة recipeCuisine.

    صيغة غير محبَّذة:

    
"keywords": "dessert, American"

    صيغة محبَّذة:

    
"keywords": "winter apple pie, nutmeg crust"
nutrition.calories

Energy

عدد السعرات الحرارية لكل حصة طعام تُقدَّم من هذه الوصفة. إذا تم تحديد nutrition.calories، يجب تحديد recipeYield مع عدد حصص الطعام.
prepTime

Duration

تمثّل هذه السمة المدة الزمنية المستغرقة لتحضير مكوّنات الطبق وتجهيز مساحة العمل المخصّصة لإعداده بالتنسيق ISO 8601.

عليك استخدامها دائمًا مع cookTime.
recipeCategory

Text

تمثل هذه الخاصية نوع الوجبة الذي تنتمي إليه الوصفة أو ترتيب تناولها. على سبيل المثال: "عشاء" أو "طبق رئيسي"، أو "حلوى"، أو "وجبة خفيفة".
recipeCuisine

Text

تمثل هذه الخاصية المنطقة التي ترتبط بها الوصفة. على سبيل المثال، وصفة "فرنسية" أو "من مناطق البحر المتوسط" أو "أمريكية"
recipeIngredient

Text

تمثّل هذه السمة مكوّنًا مستخدمًا في الوصفة.

مثلاً:


"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"
]

إرشادات إضافية:

  • اذكر فقط نص المكوِّنات الضرورية لإعداد الوصفة.
  • لا تذكر معلومات غير ضرورية، مثل تعريف المكوِّن.
recipeInstructions

HowToStep أو HowToSection أو Text

تمثّل هذه السمة خطوات تحضير الطبق.

هناك عدّة خيارات لتحديد قيمة السمة recipeInstructions. ننصح باستخدام HowToStep. يمكن أيضًا استخدام HowToSection لتجميع HowToSteps إذا كانت الوصفة تحتوي على أقسام.

  • HowToStep: حدِّد خطوات هذه الوصفة باستخدام السمة HowToStep. 
    
"recipeInstructions": [
  {
    "@type": "HowToStep",
    "name": "Preheat",
    "text": "Heat oven to 425°F.",
    "url": "https://example.com/recipe#step1",
    "image": "https://example.com/photos/recipe/step1.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Prepare crust",
    "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
    "url": "https://example.com/recipe#step2",
    "image": "https://example.com/photos/recipe/step2.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Make filling",
    "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
    "url": "https://example.com/recipe#step3",
    "image": "https://example.com/photos/recipe/step3.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cover",
    "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
    "url": "https://example.com/recipe#step4",
    "image": "https://example.com/photos/recipe/step4.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Bake",
    "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
    "url": "https://example.com/recipe#step5",
    "image": "https://example.com/photos/recipe/step5.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cool",
    "text": "Cool on cooling rack at least 2 hours before serving.",
    "url": "https://example.com/recipe#step6",
    "image": "https://example.com/photos/recipe/step6.jpg"
  }
]
  • HowToSection (للوصفات المتعدّدة الأقسام فقط): استخدِم هذه السمة لتجميع الخطوات في عدة أقسام. يمكنك الاطّلاع على HowToSection مثلاً.
  • نص لخاصية واحدة أو نص لحقل متكرر: يضم النص خطوة واحدة أو أكثر. يتعامل Google مع كل الخطوات على أنها في قسم واحد. يتم ربط قيم الخصائص المتكررة في نص واحد. وبعدها يحاول Google تلقائيًا تقسيم النص الواحد إلى خطوات مستقلة. ويحاول Google البحث عن أسماء الأقسام وأرقام الخطوات والكلمات الرئيسية وأي نوع نص آخر قد يظهر بشكل غير صحيح في نص خطوات إعداد الوصفة ثم يُزِيل كل ذلك. للحصول على أفضل النتائج، ننصحك بتحديد الخطوات بشكل واضح باستخدام السمة HowToStep. 
    
"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. The pie is ready when the or until apples are
tender and the crust is golden brown. Cool on cooling rack at least 2 hours
before serving."
]

إرشادات إضافية

  • لا تدرِج البيانات الوصفية التي تخص حقولاً أخرى. على وجه الخصوص، استخدِم الخاصية author لتحديد المؤلِّف وrecipeCuisine لأسلوب الطهي وrecipeCategory للفئة وkeywords للكلمات الرئيسية الأخرى.
  • أَدرِج نَصّ طريقة عمل الوصفة فقط، ولا تُدرِج نصًا آخر، مثل "توجيهات" أو "مشاهدة الفيديو" أو "الخطوة 1". يمكنك تحديد تلك العبارات خارج البيانات المنظَّمة.

    صيغة غير محبَّذة:

    
"recipeInstructions": [{
  "@type": "HowToStep",
  "text": "Step 1. Heat oven to 425°F."
}]

    صيغة محبَّذة:

    
"recipeInstructions": [{
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}]
recipeYield

Text أو Integer

تمثّل هذه السمة الكمية الناتجة عن الوصفة. حدِّد عدد حصص الطعام الناتجة عن هذه الوصفة من خلال إضافة رقم. وإذا أردت استخدام وحدة مختلفة (على سبيل المثال، عدد العناصر)، يمكنك إدراج أرقام إضافية. وتكون هذه السمة مطلوبة إذا حدّدت أي معلومات غذائية لكل حصة طعام (مثل nutrition.calories).

مثال


"recipeYield": [
  "6",
  "24 cookies"
]
totalTime

Duration

تمثّل هذه السمة الوقت الإجمالي الذي يستغرقه إعداد الطبق وطهيه بالتنسيق ISO 8601.

استخدِم السمة totalTime أو السمتَين cookTime وprepTime معًا.

video VideoObject

فيديو يصف الخطوات اللازمة لإعداد الطبق. اتّبِع قائمة سمات الفيديو المطلوبة والمقترَحة.

  • Video without clips 
    
{
  "@context": "https://schema.org/",
  "@type": "Recipe",
  "video": [
    {
      "@type": "VideoObject",
      "name": "Delicious PieParty Coffee Cake",
      "description": "How to make a delicious pie - quickly and easily!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": "https://www.example.com/videos/123_600x400.mp4",
      "embedUrl": "https://www.example.com/videoplayer?id=123",
      "uploadDate": "2018-02-05T08:00:00+08:00"
    }
  ]
}
]
  • Video with clips: فيديو يضم مقاطع تتوافق مع شرائح الفيديو. يمكن أن تشير الأجزاء الأخرى من الوصفة (مثل الخطوات) إلى هذه المقاطع، والتي تم تحديدها في video.hasPart. 
    
{
  "@context": "https://schema.org/",
  "@type": "Recipe",
  "video": {
    "@type": "VideoObject",
    "name": "Make a pie",
    "description": "How to make a delicious pie - quickly and easily!",
    "thumbnailUrl": "https://example.com/photos/photo.jpg",
    "contentUrl": "https://www.example.com/videos/123_600x400.mp4",
    "embedUrl": "https://www.example.com/videoplayer?id=123",
    "uploadDate": "2018-02-05T08:00:00+08:00",
    "duration": "P1MT10S",
    "hasPart": [{
      "@type": "Clip",
      "@id": "Clip1",
      "name": "Preheat oven",
      "startOffset": 20,
      "endOffset": 29
      "url": "https://www.example.com/example?t=20"
     },
     {
       "@type": "Clip",
       "@id": "Clip2",
       "name": "Arrange pie crust",
       "startOffset": 29,
       "endOffset": 36
       "url": "https://www.example.com/example?t=29"
     },
     {
       "@type": "Clip",
       "@id": "Clip3",
       "name": "Make filling",
       "startOffset": 36,
       "endOffset": 45
       "url": "https://www.example.com/example?t=36"
     },
     {
       "@type": "Clip",
       "@id": "Clip4",
       "name": "Add filling",
       "startOffset": 45,
       "endOffset": 65
       "url": "https://www.example.com/example?t=45"
     },
     {
       "@type": "Clip",
       "@id": "Clip5",
       "name": "Bake",
       "startOffset": 65,
       "endOffset": 80
       "url": "https://www.example.com/example?t=65"
     },
     {
       "@type": "Clip",
       "@id": "Clip6",
       "name": "Let cool",
       "startOffset": 80,
       "endOffset": 90
       "url": "https://www.example.com/example?t=80"
    }]
  }
}
video.contentUrl

URL

تمثّل هذه السمة عنوان URL يشير إلى ملف وسائط الفيديو بأحد تنسيقات الترميز المتوافقة. لا تضع رابطًا يؤدي إلى الصفحة التي يظهر فيها الفيديو، بل يجب أن يكون هذا الرابط عنوان URL لملف وسائط الفيديو نفسه.


"contentUrl": "https://www.example.com/video/123/file.mp4"

احرص على اتّباع أفضل ممارسات الفيديو.
video.hasPart

Clip

مقطع فيديو يمثّل جزءًا من الفيديو الكامل.

video.hasPart.endOffset

Number

وقت انتهاء المقطع، ويتم التعبير عنه بعدد الثواني من بداية الفيديو.

video.hasPart.name

Text

تمثّل هذه السمة اسم المقطع. على سبيل المثال، يمكن أن يكون "تحضير قشرة الفطيرة" هو اسم المقطع الذي يعرض كيفية تحضير قشرة الفطيرة والضغط عليها داخل صينية الفطيرة.

video.hasPart.startOffset

Number

وقت بدء المقطع، ويتم التعبير عنه بعدد الثواني من بداية الفيديو.

video.hasPart.url

URL

رابط للانتقال إلى بداية المقطع. يجب أن تتطابق بداية المقطع مع القيمة المُحدَّدة في video.hasPart.startOffset. مثلاً: 


"startOffset": 20,
"endOffset": 29,
"url": "https://www.example.com/example?t=20"

HowToSection

يمكنك استخدام HowToSection لتجميع سلسلة من الخطوات (أو الأقسام الفرعية) التي تُشكِّل جزءًا من تعليمات إعداد الوصفة. حدِّد HowToSection مباشرةً ضمن تعريف خاصية recipeInstructions، أو على أنه itemListElement لخاصية HowToSection أخرى.

يحدد النوع HowToSection قسمًا لوصفة واحدة ويحتوي على خطوة واحدة أو عدة خطوات. لا تستخدم HowToSection لتحديد وصفات مختلفة لصنف الطعام نفسه، بل استخدِم HowToSection كجزء من وصفة واحدة. لسرد وصفات متعددة للطبق نفسه، استخدِم كائنات Recipe متعددة. على سبيل المثال، لعرض طرق متعدّدة لتحضير فطيرة تفاح، أدرِجها على أنها عناصر Recipe متعددة، وليس عناصر HowToSection.

يتوفّر تعريف HowToSection الكامل على schema.org/HowToSection.

السمات المطلوبة
itemListElement HowToStep

قائمة بالخطوات التفصيلية للقسم و/أو الأقسام الفرعية. يمكن أن تتضمن وصفة البيتزا مثلاً قسمًا لخطوات إعداد العجينة وقسمًا لتحضير الطبقات الفوقية وقسمًا لخلط المكونات وخَبزها. إذا كانت الوصفة تحتوي على أقسام، ولكن لم يتم تحديدها باستخدام HowToSections، قد يعرض &quot;مساعد Google‏&quot; عن طريق الخطأ اسم القسم كخطوة أخرى فقط (على سبيل المثال، خطوة "إعداد العجينة" متبوعة بخطوة "خلط الدقيق والخميرة").

مثال:


{
  "@type": "HowToSection",
  "name": "Assemble the pie",
  "itemListElement": [
    {
      "@type": "HowToStep",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate."
    }, {
      "@type": "HowToStep",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust."
    }
  ]
}
name Text

تمثّل هذه السمة اسم القسم.

HowToStep

يمكنك استخدام HowToStep لتجميع جملة أو أكثر توضّح كيفية تنفيذ جزء من الوصفة. حدِّد السمة text باستخدام الجُمل أو حدِّد السمة itemListElement بالتناوب، باستخدام السمة HowToDirection أو HowToTip لكل جملة.

يمكنك ترميز خطوات وصفتك باستخدام السمات التالية لنوع HowToStep. حدِّد السمة HowToStep مباشرةً ضمن تعريف السمة recipeInstructions أو على أنّها itemListElement لسمة HowToSection.

يتوفّر التعريف الكامل للسمة HowToStep على schema.org/HowToStep.

السمات المطلوبة
itemListElement HowToDirection أو HowToTip

تمثل هذه السمة قائمة بالخطوات الفرعية التفصيلية بما يشمل التوجيهات أو النصائح.

وتكون اختيارية في حال استخدام text.
text Text

تمثل هذه السمة النص الكامل لتعليمات هذه الخطوة.

وتكون اختيارية في حال استخدام itemListElement. إرشادات إضافية:

  • أدرِج نصًا تعليميًا فقط ولا تُدرِج نصًا آخر مثل &quot;التوجيهات&quot; أو &quot;مشاهدة الفيديو&quot; أو &quot;الخطوة 1&quot;. حدِّد العبارات غير المستخدمة في السمة التي تم ترميزها.

    صيغة غير محبَّذة:

    
{
  "@type": "HowToStep",
  "text": "Step 1. Heat oven to 425°F."
}

    صيغة محبَّذة:

    
{
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}
السمات المقترَحة
image ImageObject أو URL

تمثل هذه السمة صورة للخطوة. إرشادات إضافية للصور:

  • يجب أن تكون جميع عناوين URL للصور قابلة للزحف والفهرسة.
  • يجب أن تمثّل الصور المحتوى الذي تم ترميزه.
  • يجب أن تكون الصور بالتنسيق ‎.jpg أو ‎.png أو ‎.gif.
name Text

الكلمة أو العبارة القصيرة التي تلخّص الخطوة (على سبيل المثال، "تحضير قشرة الفطيرة"). لا تستخدِم نصًا غير وصفي (مثل "الخطوة 1: [نص]") أو أي شكل آخر من أشكال ترقيم الخطوات (مثل "1. [نص]&quot;).

url URL

تمثّل هذه السمة عنوان URL الذي يؤدي مباشرةً إلى الخطوة (إذا كان متاحًا)، مثلاً جزء من رابط إلى موضع ثابت.

video VideoObject أو Clip

تمثّل هذه السمة فيديو لهذه الخطوة أو مقطعًا من الفيديو.

بالنسبة إلى السمة VideoObject، اتّبِع قائمة السمات المطلوبة والمقترَحة لكل منالفيديو أو المقطع.

HowToDirection وHowToTip

استخدِم السمة HowToDirection والسمة HowToTip لوصف التوجيهات أو النصائح، مع العِلم أنهما يستخدمان السمات المطلوبة والمقترَحة نفسها.

يتوفّر تعريفا HowToDirection وHowToTip الكاملان على schema.org/HowToDirection وschema.org/HowToTip.

السمات المطلوبة
text Text

تمثّل هذه السمة نص التوجيه أو النصيحة.

ItemList

فضلاً عن سمات وصفة الطعام، أضِف السمات التالية المتعلقة بالقوائم المحددة حسب المضيف. ليس مطلوبًا تقديم السمة ItemList، ولكن يجب إضافة السمات التالية إذا أردت أن تكون وصفة الطعام مؤهّلة للظهور في لوحة العرض الدوّارة الخاصة بالمضيف. لمزيد من المعلومات حول لوحة العرض الدوّارة الخاصة بالمضيف، راجِع المقالة لوحة العرض الدوّارة.

يتوفّر تعريف ItemList الكامل على schema.org/ItemList.

السمات المطلوبة
itemListElement

ListItem

تمثّل هذه السمة تعليقًا توضيحيًا لصفحة عنصر واحد.
ListItem.position

Integer

تمثّل هذه السمة ترتيب صفحة العنصر في القائمة. مثلاً:


"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]
ListItem.url

URL

تمثّل هذه السمة عنوان URL الأساسي لصفحة السلعة. ويجب تخصيص عنوان URL فريد لكل عنصر.

مراقبة النتائج المنسّقة باستخدام Search Console

Search Console هي أداة تساعدك في مراقبة مستوى أداء صفحاتك في &quot;بحث Google&quot;. ليس عليك الاشتراك في Search Console لإدراج موقعك الإلكتروني ضمن نتائج &quot;بحث Google&quot;، ولكن تساعدك هذه الأداة في التعرّف على شكل موقعك كما يراه محرّك البحث Google وتحسين هذا الشكل. ننصح بالتحقق من Search Console في الحالات التالية:

  1. بعد نشر بيانات منظَّمة للمرة الأولى
  2. بعد إصدار نماذج جديدة أو تعديل الترميز
  3. تحليل الزيارات بشكل دوري

بعد نشر بيانات منظَّمة للمرة الأولى

بعد أن ينتهي محرّك بحث Google من فهرسة الصفحات، تحقَّق مما إذا كان هناك أي مشاكل باستخدام تقرير &quot;حالة النتائج المنسّقة&quot; المناسب. من المفترض أن ترى زيادة في العناصر الصالحة وليس في العناصر غير الصالحة. إذا عثرت على مشاكل في بياناتك المنظَّمة:

  1. أصلِح العناصر غير الصالحة.
  2. افحص عنوان URL منشور لمعرفة ما إذا لا تزال المشكلة مستمرّة.
  3. اطلب إجراء تحقُّق من الإصلاحات باستخدام تقرير الحالة.

بعد إصدار نماذج جديدة أو تعديل الترميز

عندما تُجري تغييرات كبيرة على موقعك الإلكتروني، عليك مراقبة الزيادات في عدد العناصر غير الصالحة ضمن البيانات المنظَّمة.
  • إذا لاحظت زيادة في عدد العناصر غير الصالحة، قد يكون السبب أنّك طرحت نموذجًا جديدًا لا يعمل أو أنّ موقعك الإلكتروني يتفاعل مع النموذج الحالي بطريقة جديدة وغير صحيحة.
  • إذا لاحظت انخفاضًا في العناصر الصالحة (لا تقابله زيادة في عدد العناصر غير الصالحة)، قد يشير ذلك إلى أنّك توقّفت عن تضمين بيانات منظَّمة في صفحاتك. استخدِم أداة فحص عنوان URL للاطّلاع على سبب المشكلة.

تحليل الزيارات بشكل دوري

يمكنك تحليل الزيارات إلى صفحتك في &quot;بحث Google&quot; باستخدام تقرير الأداء. ستعرض لك البيانات عدد مرات ظهور صفحتك كنتيجة منسّقة في &quot;بحث Google&quot; وعدد المرات التي نقر فيها المستخدمون على الصفحة ومتوسط موضع ظهور الصفحة في نتائج البحث. يمكنك أيضًا عرض هذه النتائج تلقائيًا باستخدام Search Console API.

تحديد المشاكل وحلّها

إذا كنت تواجه مشكلة في تطبيق البيانات المنظَّمة أو تصحيح الأخطاء فيها، إليك بعض المراجع التي قد تساعدك.