مخطط Recipe

كيفية تنفيذ ترميز schema.org/Recipe لنتيجة الوصفة المنسقة في Google — الخصائص المطلوبة والموصى بها، ومتطلبات منصة العرض الدوارة ItemList، وحقول التغذية والوقت والتقييم الشرطية، وخاصية الفيديو، وقاعدة أن الأطباق الحقيقية وحدها تتأهل.

نُشر أول مرة: 1 يوليو 2026 · آخر تحديث: 13 أغسطس 2026 · Advanced
اللغات

مخطط Recipe ‏(schema.org/Recipe) هو بيانات منظمة تعرّف لمحركات البحث اسم طبق الصفحة وصورته ووقت طهيه وتقييماته ومكوناته وتغذيته، لكي تصبح مؤهلة لنتيجة الوصفة المنسقة في Google. لا تُطلب بصورة صارمة سوى image وname، لكن البطاقة الأغنى تُملأ من الخصائص الموصى بها، ومنها aggregateRating وauthor والأوقات وrecipeYield وrecipeIngredient وrecipeInstructions والتصنيف والمطبخ والكلمات المفتاحية والتاريخ وnutrition.calories وvideo. تحتاج منصة عرض الوصفات المتعددة إلى صفحة ItemList على مستوى الموقع المضيف — إما صفحة ملخص ترتبط بوصفات منفصلة أو صفحة شاملة ترتبط بمراسٍ داخلها — ولا يكفي ترميز الوصفة الفردية. كما أن Recipe صالح للأطباق الحقيقية فقط، ويجب أن يطابق الترميز المحتوى المرئي. يمنح الترميز الصالح الأهلية فحسب؛ وتظل Google صاحبة قرار العرض.

الخلاصة — يجعل ترميز schema.org/Recipe (بصيغة JSON-LD عادةً) صفحة الوصفة مؤهلة لـ نتيجة الوصفة المنسقة في Google — بطاقة مرئية (صورة، وتقييم بالنجوم، ووقت طهي، وسعرات حرارية) يمكن أن تظهر في منصة عرض دوارة/شبكة في صفحة النتائج، ومع شارات وصفات في صور Google. لا تُطلب بصورة صارمة سوى image وname؛ لكن البطاقة تُبنى فعلياً من مجموعة الخصائص الموصى بها (aggregateRating، وauthor، وcookTime، وprepTime، وtotalTime، وrecipeYield، وrecipeIngredient، وrecipeInstructions، وrecipeCategory، وrecipeCuisine، وkeywords، وdatePublished، وnutrition.calories، وvideo). وهناك حقيقتان في التنفيذ تتجاوزهما معظم الملخصات: منصة عرض الوصفات المتعددة ميزة على مستوى الموقع المضيف تتطلب صفحة ItemList — إما صفحة ملخص ترتبط بصفحات وصفات منفصلة، وإما صفحة شاملة ترتبط بمراسي داخلها — فترميز الوصفة وحده يمنح بطاقة واحدة لا منصة عرض دوارة؛ كما أن مخطط Recipe صالح فقط للأطباق الحقيقية (ومن أمثلة Google المضادة «مقشّر وجه» و«أفكار حفلات»). تستخدم الأوقات مدد ISO 8601 (PT20M)، وأكثر أسباب عدم ظهور وصفة صالحة شيوعاً هو عدم تطابق المحتوى بين الترميز والصفحة المرئية. ومع VideoObject، هذا واحد من نوعي البيانات المنظمة في مجموعة CreativeWork اللذين ينتجان نتيجة منسقة حقيقية ومرئية — لا عامل ترتيب أو معدل نقر أو زيارات موثقاً، بل تحسين مرئي فعلياً عند ظهوره.

Evidence for this claim Schema.org Recipe describes a recipe and its ingredients, instructions, timing, nutrition, and related metadata. Scope: Schema.org Recipe vocabulary. Confidence: high · Verified: Schema.org: Recipe Evidence for this claim Google's Recipe feature requires name and image and documents additional recommended properties; complete valid markup earns eligibility, not guaranteed display or ranking. Scope: Current Google Recipe structured-data requirements. Confidence: high · Verified: Google Search Central: Recipe structured data

كيف تبدو نتيجة الوصفة المنسقة — وكيف تُبنى؟

تعرض Google ترميز Recipe بوصفه بطاقة مرئية: صورة image المصغرة، وname، ونجوم aggregateRating وعددها، ووقت الطهي (من totalTime أو cookTime). وفي كثير من استعلامات الوصفات، تُجمع هذه البطاقات في منصة عرض دوارة أو شبكة أعلى النتائج، كما تحصل الوصفات المرمّزة على شارات وصفات في صور Google، وهي مساحة اكتشاف مهمة لمحتوى الطعام.

تصوغ Google الغرض كله هكذا: “Help users find your recipe content by telling Google about your recipe with structured data.” (ترجمة) «ساعد المستخدمين على العثور على محتوى وصفتك بإخبار Google عن وصفتك باستخدام البيانات المنظمة.» وهذا هو النموذج الذهني: لا تطلب تعزيزاً للترتيب؛ بل تجعل المحتوى قابلاً لقراءة الآلة بما يكفي للتأهل لميزة مرئية محددة.

المطلوب مقابل الموصى به — ولماذا تقلل كلمة «مطلوب» من شأنه؟

هذا هو جدول الخصائص المهم. لا تضع Google علامة «مطلوب» إلا على خاصيتين، وهذا مضلل فعلاً إن توقفت عن القراءة هناك؛ فوصفة لا تضم سوى name وimage تجتاز التحقق لكنها تنتج نتيجة ضئيلة وغير جذابة.

مطلوب

الخاصيةملاحظات
nameاسم الطبق. يجب أن يكون طبقاً حقيقياً (انظر سياسة المحتوى أدناه).
imageصورة الطبق النهائي. يجب أن تكون قابلة للزحف والفهرسة، وفي تنسيق مدعوم، وممثلة للطبق. توصي Google بصور متعددة بنسب 16x9 و4x3 و1x1، لا تقل كل منها عن 50 000 بكسل — ولا يوجد شرط منفصل بعرض 1 200 بكسل كما تذكر بعض الأدلة.

موصى به (تستخدمه Google لبناء البطاقة الأغنى عندما تقرر عرضها — ولا يجبر ملء هذه الحقول Google على العرض)

الخاصيةما الذي تؤثر فيه؟
aggregateRatingالتقييم بالنجوم + العدد في البطاقة. يخضع لإرشادات مقتطفات المراجعات؛ وإذا عرضت مراجعة واحدة بدلاً من متوسط، فيجب أن يكون المراجع شخصاً أو مؤسسة مسماة.
authorالإسناد.
datePublishedإشارة الحداثة؛ تاريخ ISO 8601.
descriptionنص الملخص.
keywordsوسوم نصية حرة (مثل “winter, comfort food”). وليست مثل recipeCategory.
nutrition.caloriesيغذي رقم السعرات الذي قد تعرضه Google. شرطي: إذا عيّنت nutrition.calories، فيجب تعريف recipeYield أيضاً.
prepTimeمدة التحضير، بصيغة ISO 8601 ‏(PT15M). توجيه Google: اربطها دائماً بـ cookTime.
cookTimeمدة الطهي، بصيغة ISO 8601 ‏(PT1H). اربطها بـ prepTime.
totalTimeالمدة الإجمالية. استخدم totalTime أو الجمع بين prepTime وcookTime؛ تقبل Google كليهما.
recipeCategoryنوع الوجبة — “appetizer” و”dessert” و”main course”.
recipeCuisineالمطبخ الإقليمي — “Mediterranean” و”Thai”.
recipeIngredientإدخال واحد لكل مكون، مع الكمية (“2 cups flour”).
recipeInstructionsالخطوات — ويُفضل أن تكون كائنات HowToStep، ويمكن تجميعها في HowToSection.
recipeYieldالحصص أو الكمية الناتجة. مطلوب إذا قدّمت أي معلومات تغذية لكل حصة.
videoكائن VideoObject لفيديو طهي مضمن — اتبع حقوله المطلوبة والموصى بها (انظر أدناه).

تقبل Google كلاً من totalTime وزوج prepTime/cookTime؛ قدم totalTime مباشرة متى استطعت، لأنه المدة المنفردة الأرجح ظهوراً في البطاقة.

تستخدم الأوقات مدد ISO 8601 لا نصاً حراً

خطأ شائع في التحقق: cookTime: "20 minutes" غير صالح. تستخدم المدد تنسيق ISO 8601PT (فترة زمنية) مع القيمة — ولذلك تمثل PT20M مدة 20 دقيقة، وتمثل PT1H30M ساعة ونصفاً. وتستخدم التواريخ مثل datePublished تواريخ ISO 8601 ‏(2026-07-01). ويعد الخطأ في هذه التنسيقات من أكثر أسباب فشل الوصفة في Rich Results Test شيوعاً.

تحتاج منصة العرض الدوارة إلى ItemList — ولا يكفي الترميز الفردي

هذه تفصيلة التنفيذ التي تتجاوزها عادةً مقالات «أنواع المخططات» العامة. فهنا شيئان مختلفان:

  • بطاقة الوصفة الواحدة — يحصل عليها ترميز Recipe في صفحة الوصفة الفردية.
  • منصة عرض الوصفات الدوارة/الشبكةمنصة عرض على مستوى الموقع المضيف، وهي ميزة منفصلة.

لكي تصبح مؤهلاً لمنصة عرض الوصفات المتعددة، تضيف صفحة ItemList — وتدعم وثائق Google لمنصة العرض على مستوى الموقع المضيف نموذجين مختلفين للصفحة، لا نموذجاً واحداً:

  • صفحة ملخص — صفحة (تصنيف أو تجميع — «15 وصفة معكرونة لأيام الأسبوع») تضم وصفاً موجزاً لكل عنصر، ويشير كل ListItem بالترتيب إلى عنوان URL لصفحة تفاصيل وصفة منفصلة تضم بدورها ترميز Recipe كاملاً. وهذا هو النمط الذي تصفه معظم الأدلة.
  • صفحة شاملة — صفحة واحدة تحتوي بنفسها على الترميز الكامل لكل عنصر، ولا ترتبط بصفحات تفاصيل منفصلة؛ يحمل كل ListItem كائن item (مع name وurl يشير إلى مرساة في الصفحة نفسها) بدلاً من رابط إلى صفحة أخرى.

يوفر كلا النموذجين التسلسل الذي تحتاج إليه Google لمنصة العرض؛ ويعتمد الأنسب على ما إذا كانت وصفاتك موجودة بالفعل في عناوين URL مستقلة (صفحة الملخص)، أم أنك تعرضها كلها في صفحة طويلة واحدة (الصفحة الشاملة).

النتيجة العملية: لا يمكنك الحصول على منصة عرض دوارة من صفحة وصفة عادية واحدة. تمنح صفحة الوصفة المفردة ذات الترميز الممتاز بطاقة واحدة. وإذا أردت منصة العرض، فتحتاج إلى أحد نموذجي صفحة ItemList أعلاه، فوق ترميز Recipe الكامل (أو حاوياً له). وتفويت هذه الخطوة هو السبب الأول لقول الناس: «ترميزي مثالي، لكنني لا أحصل على منصة عرض دوارة».

معلومات التغذية

nutrition كائن NutritionInformation، وnutrition.calories هو الحقل الذي تسميه Google صراحةً؛ فهو يغذي رقم السعرات الذي قد تعرضه Google في النتيجة المنسقة. وهذا متطلب بيانات، لا وعد بمعلومات تغذية مستقلة قابلة للتوسيع في كل مرة؛ فوثائق Google تصف الحقل لا عنصراً مضموناً في الواجهة. وهناك شرط مرفق: إذا عيّنت nutrition.calories، فيجب تعريف recipeYield أيضاً، لأن السعرات تُذكر لكل حصة وتحتاج Google إلى عدد الحصص لفهم الرقم. ويمكنك إضافة fatContent و proteinContent وcarbohydrateContent وsodiumContent وغيرها، لكن الجمع بين calories وrecipeYield هو الأرجح ظهوراً. القيم سلاسل نصية مع الوحدات (“240 calories” و”9 g”). وهي كتلة صغيرة تضيف إلى بطاقتك تفصيلاً مرئياً ومميزاً، لذا يستحق ملؤها لكل وصفة تستطيع حسابها بصدق.

Evidence for this claim If nutrition.calories is supplied, Google requires recipeYield to identify the number of servings. Current documentation describes a data condition; it does not promise a distinct expandable nutrition panel in every result. Scope: web Confidence: high · Verified: Recipe structured data

الفيديو: حيث يلتقي Recipe بـ VideoObject

تضمّن صفحات وصفات كثيرة فيديو طهي، وخاصية video هي موضع تقاطع Recipe و VideoObject — نوعي CreativeWork اللذين ينتجان نتائج منسقة حقيقية ومرئية. توجيه Google صريح: تستقبل video كائن VideoObject كاملاً، ويجب أن يتبع حقول هذه الميزة المطلوبة والموصى بها (name وdescription وthumbnailUrl و uploadDate وcontentUrl أو embedUrl)؛ فتقديم عنوان فيديو مجرد لا يساوي ملف التعريف الفرعي الموثق. وعند تنفيذه بصورة صحيحة، يمكن للوصفة التأهل لمعالجة الفيديو ولبطاقة الوصفة، ويصبح الفيديو مؤهلاً لمساحاته الخاصة. توجد متطلبات كل حقل للفيديو مع موضوع VideoObject — ويندرج الكائن نفسه داخل الوصفة، لذا يستحق ضبط الترميز بدلاً من وضع video: {} فارغ.

سياسة المحتوى: أطباق حقيقية فقط وتطابق مع الصفحة المرئية

هذا أكثر أسباب عدم ظهور ترميز صالح شيوعاً. يقتصر مخطط Recipe على الطعام الحقيقي. وتقول Google بوضوح: “Use Recipe structured data for content about preparing a particular dish. For example, ‘facial scrub’ or ‘party ideas’ are not valid names for a dish.” (ترجمة) «استخدم بيانات Recipe المنظمة للمحتوى المتعلق بإعداد طبق معين. فعلى سبيل المثال، لا يُعد «مقشر الوجه» أو «أفكار الحفلات» اسمين صالحين لطبق.» وتعد «وصفة» منظف منزلي، أو مقالة «وصفة للنجاح»، أو تجميع أفكار حفلات مموهاً بترميز Recipe مخالفة للسياسة؛ فقد يجتاز الترميز المدقق النحوي ولا يحصل مطلقاً على بطاقة، أو يتعرض لإجراء يدوي.

والنصف الثاني من المبدأ نفسه: يجب أن يعكس الترميز الصفحة المرئية. إذا سرد JSON-LD مكونات أو أوقاتاً أو تقييماً لا توجد فعلياً في الصفحة التي يراها المستخدم، فهذا عدم تطابق تعده Google إشارة غير مرغوب فيها. لا ترمّز إلا ما هو موجود حقاً.

لماذا لا تعرض وصفتك الصالحة نتيجة منسقة؟

الأهلية ليست عرضاً. التسلسل المعتاد: يجب أن تكون الصفحة مفهرسة، وأن يكون الترميز صالحاً، وأن يكون المحتوى طبقاً حقيقياً معروضاً في الصفحة، وأن تقرر أنظمة Google أن عرضه يستحق — وهي قاعدة الأهلية لا الضمان التي تحكم كل نوع من البيانات المنظمة. إذا اجتزت صلاحية الترميز وسياسة المحتوى ولم تر بطاقة، فالأسباب الشائعة هي: أوقات مكتوبة بنص حر بدلاً من ISO 8601، أو aggregateRating بلا عدد، أو صورة لا تلبي إرشادات الحجم/النسبة، أو توقع منصة عرض دوارة بلا صفحة ItemList.

لمعرفة موضع Recipe في الصورة الأوسع للبيانات المنظمة، راجع مركزي Schema Markup وStructured Data الأشمل اللذين تندرج تحتهما هذه المقالة.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.